CertSelectionGetSerializedBlob 函数 (cryptuiapi.h)

  • 项目

CertSelectionGetSerializedBlob 函数是用于从CERT_SELECTUI_INPUT结构检索序列化证书 BLOB 的帮助程序函数。

语法

HRESULT CertSelectionGetSerializedBlob(
  [in]  PCERT_SELECTUI_INPUT pcsi,
  [out] void                 **ppOutBuffer,
  [out] ULONG                *pulOutBufferSize
);

参数

[in] pcsi

指向包含证书存储和证书上下文链信息的 CERT_SELECTUI_INPUT 结构的指针。

[out] ppOutBuffer

指向接收序列化证书 BLOB 的缓冲区的指针的地址。

[out] pulOutBufferSize

指向 ULONG 的指针，用于接收 ppOutBuffer 参数指向的缓冲区中收到的 BLOB 的大小（以字节为单位）。

返回值

如果函数成功，该函数将返回 S_OK。

如果函数失败，它将返回一个 指示错误的 HRESULT 值。 如果 hStore 和 prgpChain 参数都不为 NULL，则返回 E_INVALIDARG。 有关常见错误代码的列表，请参阅 通用 HRESULT 值。

注解

返回的序列化 BLOB 将传递到 pvInAuthBuffer 参数中的 CredUIPromptForWindowsCredentials 函数，以允许用户使用凭据选择 UI 选择证书。

此函数的 ppOutBuffer 参数指向的缓冲区中返回的 BLOB 中序列化的证书取决于CERT_SELECTUI_INPUT结构的 hStore 和 prgpChain 成员的值。

hStore prgpChain 序列化的证书
NULL 非 null 将序列化 prgpChain 成员指向的证书。
非 null NULL 由 hStore 成员指定的证书将序列化。
NULL NULL 返回空 BLOB。
非 null 非 null 调用失败，函数返回 E_INVALIDARG。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 cryptuiapi.h
DLL Cryptui.dll