NCryptFinalizeKey 函数 (ncrypt.h)

NCryptFinalizeKey 函数完成 CNG 密钥存储密钥。 在调用此函数之前,不能使用该键。

语法

SECURITY_STATUS NCryptFinalizeKey(
  [in] NCRYPT_KEY_HANDLE hKey,
  [in] DWORD             dwFlags
);

参数

[in] hKey

要完成的密钥的句柄。 此句柄是通过调用 NCryptCreatePersistedKey 函数获取的。

[in] dwFlags

修改函数行为的标志。 这可以是零,也可以是以下一个或多个值的组合。

含义
NCRYPT_NO_KEY_VALIDATION
不要验证密钥对的公共部分。 此标志仅适用于公钥/私钥对。
NCRYPT_WRITE_KEY_TO_LEGACY_STORE_FLAG
此外,请将密钥保存在旧存储中。 这允许将密钥与 CryptoAPI 一起使用。 此标志仅适用于 RSA 密钥。
NCRYPT_SILENT_FLAG
请求关键服务提供程序 (KSP) 不显示任何用户界面。 如果提供程序必须显示 UI 才能运行,则调用会失败,KSP 应将 NTE_SILENT_CONTEXT 错误代码设置为最后一个错误。

返回值

返回指示函数成功或失败的状态代码。

可能的返回代码包括但不限于以下内容。

返回代码 说明
ERROR_SUCCESS
函数成功。
NTE_BAD_FLAGS
dwFlags 参数包含无效的值。
NTE_INVALID_HANDLE
hKey 参数无效。

注解

服务不得从其 StartService 函数调用此函数。 如果服务从其 StartService 函数调用此函数,则可能会出现死锁,并且服务可能会停止响应。

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 ncrypt.h
Library Ncrypt.lib
DLL Ncrypt.dll