CertFindSubjectInSortedCTL 函数 (wincrypt.h)

  • 项目

CertFindSubjectInSortedCTL 函数尝试在 CTL) (排序的证书信任列表中查找指定的主题。 使用者可以通过证书的整个上下文或证书使用者的任何唯一标识符（例如证书颁发者和序列号的 SHA1 哈希 ）来标识。

语法

BOOL CertFindSubjectInSortedCTL(
  [in]  PCRYPT_DATA_BLOB pSubjectIdentifier,
  [in]  PCCTL_CONTEXT    pCtlContext,
  [in]  DWORD            dwFlags,
  [in]  void             *pvReserved,
  [out] PCRYPT_DER_BLOB  pEncodedAttributes
);

参数

[in] pSubjectIdentifier

指向唯一标识主题 的CRYPT_DATA_BLOB 结构的指针。 此结构中的信息可以是 哈希 或任何唯一字节序列。

[in] pCtlContext

指向要搜索 的CTL_CONTEXT 结构的指针。

[in] dwFlags

保留供将来使用，必须为 NULL。

[in] pvReserved

保留供将来使用，必须为 NULL。

[out] pEncodedAttributes

指向 CRYPT_DER_BLOB 结构的指针，该结构包含字节计数和指向主体编码属性的指针。

返回值

如果函数成功且 CTL 中存在使用者标识符，则返回值为 TRUE。

如果函数失败并且找不到匹配的主题标识符，则返回值为 FALSE。

要求

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

另请参阅

CTL_CONTEXT

CertEnumSubjectInSortedCTL

证书和证书存储维护函数