PvkPrivateKeyAcquireContextFromMemory 函数

重要

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

 

PvkPrivateKeyAcquireContextFromMemory 函数在加密服务提供程序中创建一个临时容器, (云解决方案提供商) 并将私钥从内存加载到容器中。

备注

此函数没有关联的头文件或导入库。 若要调用此函数,必须创建用户定义的头文件,并使用 LoadLibraryGetProcAddress 函数动态链接到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 中请求的云解决方案提供商的名称。

dwProvType [in]

云解决方案提供商类型的 DWORD 值。 有关云解决方案提供商类型的详细信息,请参阅加密提供程序类型

pbData [in]

指向用于接收上下文数据的缓冲区的指针。 调用方必须提供此资源。

cbData [in]

一个 DWORD 值,该值指定 pbData 缓冲区的大小(以字节为单位)。 调用方必须提供此值。

hwndOwner [in]

如果需要密码来解密 pbData 参数指向的上下文数据,则此参数是对话框父级的句柄;否则为 NULL

pwszKeyName [in]

指向包含要检索的键名称的 null 终止字符串的指针。

pdwKeySpec [in, out, optional]

指向指定键类型的 DWORD 值的指针。 可能的值包括 AT_KEYEXCHANGEAT_SIGNATURE

phCryptProv [out]

指向云解决方案提供商句柄的指针。

ppwszTmpContainer [out]

指向临时容器名称的 null 终止字符串的指针的地址。 PvkPrivateKeyAcquireContextFromMemory 函数提供此字符串的缓冲区并初始化它。 调用 PvkPrivateKeyAcquireContextFromMemory 时,地址应指向 NULL 值。

返回值

成功后,此函数返回 TRUEPvkPrivateKeyAcquireContextFromMemory 函数在失败时返回 FALSE

要求

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