PvkPrivateKeyAcquireContextFromMemory 函数
重要
已弃用此 API。 Microsoft 可能会在将来的版本中删除此 API。
PvkPrivateKeyAcquireContextFromMemory 函数在加密服务提供程序中创建一个临时容器， (CSP) 并将私钥从内存加载到容器中。
注意
此函数没有关联的头文件或导入库。 若要调用此函数，必须创建用户定义的头文件，并使用 LoadLibrary 和 GetProcAddress 函数动态链接到Mssign32.dll。
语法
BOOL WINAPI PvkPrivateKeyAcquireContextFromMemory(
_In_ LPCWSTR pwszProvName,
_In_ DWORD dwProvType,
_In_ BYTE *pbData,
_In_ DWORD cbData,
_In_ HWND hwndOwner,
_In_ LPCWSTR pwszKeyName,
_Inout_opt_ DWORD *pdwKeySpec,
_Out_ HCRYPTPROV *phCryptProv,
_Out_ LPTSTR *ppwszTmpContainer
);
参数
-
pwszProvName [in]
-
指向以 null 结尾的字符串的指针，该字符串包含在 dwProvType 中请求其类型的 CSP 的名称。
-
dwProvType [in]
-
CSP 类型的 DWORD 值。 有关 CSP 类型的详细信息，请参阅 加密提供程序类型。
-
pbData [in]
-
指向用于接收上下文数据的缓冲区的指针。 调用方必须提供此资源。
-
cbData [in]
-
一个 DWORD 值，该值指定 pbData 缓冲区的大小（以字节为单位）。 调用方必须提供此值。
-
hwndOwner [in]
-
如果需要密码来解密 pbData 参数指向的上下文数据，则此参数是对话框的父级的句柄;否则为 NULL。
-
pwszKeyName [in]
-
指向以 null 结尾的字符串的指针，该字符串包含要检索的键的名称。
-
pdwKeySpec [in， out， optional]
-
指向指定键类型的 DWORD 值的指针。 可能的值包括 AT_KEYEXCHANGE 或 AT_SIGNATURE。
-
phCryptProv [out]
-
指向 CSP 句柄的指针。
-
ppwszTmpContainer [out]
-
指向临时容器名称的以 null 结尾的字符串的指针的地址。 PvkPrivateKeyAcquireContextFromMemory 函数为此字符串提供缓冲区并对其进行初始化。 调用 PvkPrivateKeyAcquireContextFromMemory 时，地址应指向 NULL 值。
返回值
成功后，此函数返回 TRUE。 如果失败， PvkPrivateKeyAcquireContextFromMemory 函数将返回 FALSE 。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows XP [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
| DLL |
|