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 |