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 |