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 |
|