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
程式庫 Crypt32.lib
Dll Crypt32.dll

另請參閱

CTL_CONTEXT

CertEnumSubjectInSortedCTL

憑證和證書存儲維護功能