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
Mssign32.dll