共用方式為

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

另請參閱

CTL_CONTEXT

CertFindSubjectInSortedCTL

憑證和憑證存放區維護函式