PvkGetCryptProv 函数

  • 项目

重要

已弃用此 API。 Microsoft 可能会在将来的版本中删除此 API。

 

PvkGetCryptProv 函数根据私钥文件或密钥容器名称获取加密服务提供程序 (CSP) 的句柄。

注意

此函数没有关联的头文件或导入库。 若要调用此函数，必须创建用户定义的头文件，并使用 LoadLibrary 和 GetProcAddress 函数动态链接到Mssign32.dll。

 

语法

HRESULT WINAPI PvkGetCryptProv(
  _In_      HWND       hwnd,
  _In_      LPCWSTR    pwszCaption,
  _In_      LPCWSTR    pwszCapiProvider,
  _In_      DWORD      dwProviderType,
  _In_      LPCWSTR    pwszPvkFile,
  _In_      LPCWSTR    pwszKeyContainerName,
  _Out_     DWORD      *pdwKeySpec,
  _Out_opt_ LPWSTR     *ppwszTmpContainer,
  _Out_     HCRYPTPROV *phCryptProv
);

参数

hwnd [in]

如果需要密码来解密私钥文件，此参数是密码对话框的父句柄;否则为 NULL。

pwszCaption [in]

指向对话框描述文字以 null 结尾的字符串的指针。

pwszCapiProvider [in]

指向 CSP 名称的以 null 结尾的字符串的指针。

dwProviderType [in]

表示加密提供程序类型的 DWORD 值。 有关详细信息，请参阅 加密提供程序类型。

pwszPvkFile [in]

指向包含私钥文件名称的以 null 结尾的字符串的指针。

pwszKeyContainerName [in]

指向私钥容器名称的以 null 结尾的字符串的指针。

pdwKeySpec [out]

指向使用 phCryptProv 和 ppwszTmpContainer 返回的容器键类型的 DWORD 值的指针。

ppwszTmpContainer [out， optional]

指向临时密钥容器名称的以 null 结尾的字符串的指针的地址。 PvkGetCryptProv 函数提供并初始化临时容器。 调用 PvkGetCryptProv 时，地址应指向 NULL 值。

phCryptProv [out]

指向 CSP 句柄的指针。

返回值

如果方法成功，则返回 S_OK。

如果方法失败，它将返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表，请参阅 通用 HRESULT 值。

备注

PvkGetCryptProv 函数首先尝试从 pwszKeyContainerName 参数指定的密钥容器名称获取提供程序句柄。 如果为 pwszKeyContainerName 参数传递 NULL，PvkGetCryptProv 会尝试从 pwszPvkFile 参数中指定的私钥文件获取提供程序。

使用完 CSP 后，通过调用 PvkFreeCryptProv 函数释放提供程序句柄和临时密钥容器。

要求

要求 值
最低受支持的客户端
 Windows XP [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
DLL
Mssign32.dll