CertSerializeCertificateStoreElement 函数 (wincrypt.h)

CertSerializeCertificateStoreElement 函数序列化证书上下文的编码证书及其编码属性。 可以将结果保存到存储中,以便以后可以检索证书和属性。

语法

BOOL CertSerializeCertificateStoreElement(
  [in]      PCCERT_CONTEXT pCertContext,
  [in]      DWORD          dwFlags,
  [out]     BYTE           *pbElement,
  [in, out] DWORD          *pcbElement
);

参数

[in] pCertContext

指向要序列化 CERT_CONTEXT 的指针。

[in] dwFlags

保留以供将来使用,必须为零。

[out] pbElement

指向接收序列化输出(包括编码证书及其属性)的缓冲区的指针。

此参数可以为 NULL ,用于设置此信息的大小,以便进行内存分配。 有关详细信息,请参阅 检索未知长度的数据

[in, out] pcbElement

指向 DWORD 值的指针,该值指定 pbElement 参数指向的缓冲区的大小(以字节为单位)。 当函数返回时, DWORD 值包含缓冲区中存储的字节数。

注意 处理缓冲区中返回的数据时,应用程序必须使用返回的数据的实际大小。 实际大小可以略小于输入时指定的缓冲区的大小。 (输入时,缓冲区大小通常指定得足够大,以确保最大输出数据适合 buffer。) 输出时,此参数指向的变量将更新,以反映复制到缓冲区的数据的实际大小。
 

返回值

如果函数成功,则返回值为 TRUE

如果函数失败,则返回值为 FALSE。 有关扩展的错误信息,请调用 GetLastError

要求

要求
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 wincrypt.h
Library Crypt32.lib
DLL Crypt32.dll

另请参阅

CertAddSerializedElementToStore

证书函数