Freigeben über


CertEnumSubjectInSortedCTL-Funktion (wincrypt.h)

Die CertEnumSubjectInSortedCTL-Funktion ruft den ersten oder nächsten TrustedSubject in einer sortierten Zertifikatvertrauensliste (Certificate Trust List , CTL) ab. Eine sortierte CTL ist eine CTL, die mit dem CERT_CREATE_CONTEXT_SORTED_FLAG festgelegt wurde. Diese Funktion kann in einer Schleife alle TrustedSubjects in einer sortierten CTL nacheinander abrufen.

Syntax

BOOL CertEnumSubjectInSortedCTL(
  [in]      PCCTL_CONTEXT   pCtlContext,
  [in, out] void            **ppvNextSubject,
  [out]     PCRYPT_DER_BLOB pSubjectIdentifier,
  [out]     PCRYPT_DER_BLOB pEncodedAttributes
);

Parameter

[in] pCtlContext

Ein Zeiger auf die zu durchsuchende CTL_CONTEXT-Struktur.

[in, out] ppvNextSubject

Ein Zeiger auf die Adresse des letzten gefundenen TrustedSubjects. Um die Enumeration zu starten, muss ppvNextSubject auf einen zeiger zeigen, der auf NULL festgelegt ist. Bei der Rückgabe wird der von ppvNextSubject adressierte Zeiger aktualisiert, um auf das nächste TrustedSubject in der codierten Sequenz zu verweisen.

[out] pSubjectIdentifier

Ein Zeiger auf eine CRYPT_DER_BLOB-Struktur , die ein TrustedSubject eindeutig identifiziert. Die Informationen in dieser Struktur können ein Hash oder eine eindeutige Bytesequenz sein.

[out] pEncodedAttributes

Ein Zeiger auf eine CRYPT_DER_BLOB-Struktur , die eine Byteanzahl und einen Zeiger auf die codierten Attribute des TrustedSubjects enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE, wobei ppvNextSubject aktualisiert wird, um auf den nächsten TrustedSubject in der codierten Sequenz zu verweisen.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Der Rückgabewert ist FALSE , wenn keine Weiteren Subjekte vorhanden sind oder ein ungültiges Argument vorhanden ist.

Hinweise

Die pbData-Membervon CRYPT_DER_BLOB-Strukturen verweisen direkt auf die codierten Bytes. Die CRYPT_DER_BLOB Strukturen selbst müssen von der Anwendung zugewiesen und freigegeben werden, aber der von den pbData-Membern dieser Strukturen adressierte Arbeitsspeicher wird von der Anwendung nicht zugeordnet und darf nicht von der Anwendung freigegeben werden.

Wenn die CTL nicht mit dem CERT_CREATE_CONTEXT_SORTED_FLAG Flag sortiert ist, tritt ein Fehler auf.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wincrypt.h
Bibliothek Crypt32.lib
DLL Crypt32.dll

Weitere Informationen

CTL_CONTEXT

CertFindSubjectInSortedCTL

Wartungsfunktionen für Zertifikat- und Zertifikatspeicher