CertEnumSubjectInSortedCTL 函式 (wincrypt.h)
CertEnumSubjectInSortedCTL函式會擷取排序憑證信任清單中的第一個或下一個 TrustedSubject, (CTL) 。 排序的 CTL 是使用CERT_CREATE_CONTEXT_SORTED_FLAG集所建立的 CTL。 在迴圈中,此函式可以依序擷取已排序 CTL 中的所有 TrustedSubject。
語法
BOOL CertEnumSubjectInSortedCTL(
[in] PCCTL_CONTEXT pCtlContext,
[in, out] void **ppvNextSubject,
[out] PCRYPT_DER_BLOB pSubjectIdentifier,
[out] PCRYPT_DER_BLOB pEncodedAttributes
);
參數
[in] pCtlContext
要搜尋 之CTL_CONTEXT 結構的指標。
[in, out] ppvNextSubject
找到最後一個 TrustedSubject 位址的指標。 若要開始列舉, ppvNextSubject 必須指向設定為 Null的指標。 傳回時, ppvNextSubject 所定址的指標會更新為指向編碼序列中的下一個 TrustedSubject。
[out] pSubjectIdentifier
CRYPT_DER_BLOB結構的指標,可唯一識別 TrustedSubject。 這個結構中的資訊可以是雜湊或任何唯一的位元組序列。
[out] pEncodedAttributes
包含位元組計數的 CRYPT_DER_BLOB 結構的指標,以及 TrustedSubject 編碼屬性的指標。
傳回值
如果函式成功,傳回值為 TRUE,且 ppvNextSubject 已更新為指向編碼序列中的下一個 TrustedSubject。
如果函式失敗,則傳回值為 FALSE。 如果沒有其他主旨或引數無效,則傳回值為 FALSE 。
備註
CRYPT_DER_BLOB結構的pbData成員會直接指向編碼的位元組。 CRYPT_DER_BLOB 結構本身必須由應用程式佈建和釋放,但由這些結構的pbData成員定址的記憶體不會由應用程式佈建,而且應用程式不得釋放。
如果未使用CERT_CREATE_CONTEXT_SORTED_FLAG旗標集排序 CTL,則會產生錯誤。
規格需求
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wincrypt.h |
程式庫 | Crypt32.lib |
Dll | Crypt32.dll |