Share via

NCryptOpenStorageProvider 函数 (ncrypt.h)

  • 项目

NCryptOpenStorageProvider 函数加载并初始化 CNG 密钥存储提供程序。

语法

SECURITY_STATUS NCryptOpenStorageProvider(
  [out]          NCRYPT_PROV_HANDLE *phProvider,
  [in, optional] LPCWSTR            pszProviderName,
  [in]           DWORD              dwFlags
);

参数

[out] phProvider

指向接收提供程序句柄 的NCRYPT_PROV_HANDLE 变量的指针。 完成使用此句柄后，将其传递给 NCryptFreeObject 函数以释放它。

[in, optional] pszProviderName

指向以 null 结尾的 Unicode 字符串的指针，该字符串标识要加载的密钥存储提供程序。 这是密钥存储提供程序的已注册别名。 此参数是可选的，可以为 NULL。 如果此参数为 NULL，则加载默认密钥存储提供程序。 以下值标识内置密钥存储提供程序。

值 含义
MS_KEY_STORAGE_PROVIDER
L“Microsoft 软件密钥存储提供程序”
 标识 Microsoft 提供的软件密钥存储提供程序。
MS_SMART_CARD_KEY_STORAGE_PROVIDER
L“Microsoft 智能卡密钥存储提供程序”
 标识 Microsoft 提供的智能卡密钥存储提供程序。
MS_PLATFORM_CRYPTO_PROVIDER
L“Microsoft Platform Crypto Provider”
 标识 Microsoft 提供的 TPM 密钥存储提供程序。

[in] dwFlags

修改函数行为的标志。 未为此函数定义任何标志。

返回值

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

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

返回代码 说明
ERROR_SUCCESS
 函数成功。
NTE_BAD_FLAGS
 dwFlags 参数包含一个或多个不支持的标志。
NTE_INVALID_PARAMETER
 一个或多个参数无效。
NTE_NO_MEMORY
 发生内存分配失败。

注解

如果返回错误条件，则提供程序将从内存中卸载。 返回失败错误后，不得调用提供程序中的函数。

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

要求

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