CertFindSubjectInSortedCTL-Funktion (wincrypt.h)
Die CertFindSubjectInSortedCTL-Funktion versucht, den angegebenen Antragsteller in einer sortierten Zertifikatvertrauensliste (Certificate Trust List , CTL) zu finden. Ein Antragsteller kann entweder durch den gesamten Kontext des Zertifikats oder durch einen eindeutigen Bezeichner des Antragstellers des Zertifikats identifiziert werden, z. B. der SHA1-Hash des Ausstellers und der Seriennummer des Zertifikats.
Syntax
BOOL CertFindSubjectInSortedCTL(
[in] PCRYPT_DATA_BLOB pSubjectIdentifier,
[in] PCCTL_CONTEXT pCtlContext,
[in] DWORD dwFlags,
[in] void *pvReserved,
[out] PCRYPT_DER_BLOB pEncodedAttributes
);
Parameter
[in] pSubjectIdentifier
Ein Zeiger auf eine CRYPT_DATA_BLOB Struktur, die den Antragsteller eindeutig identifiziert. Die Informationen in dieser Struktur können ein Hash oder eine beliebige eindeutige Bytesequenz sein.
[in] pCtlContext
Ein Zeiger auf die zu durchsuchende CTL_CONTEXT Struktur.
[in] dwFlags
Für die zukünftige Verwendung reserviert und muss NULL sein.
[in] pvReserved
Für die zukünftige Verwendung reserviert und muss NULL sein.
[out] pEncodedAttributes
Ein Zeiger auf eine CRYPT_DER_BLOB Struktur, die eine Byteanzahl und einen Zeiger auf die codierten Attribute des Antragstellers enthält.
Rückgabewert
Wenn die Funktion erfolgreich ist und der Antragstellerbezeichner in der CTL vorhanden ist, ist der Rückgabewert TRUE.
Wenn bei der Funktion ein Fehler auftritt und kein übereinstimmende Antragstellerbezeichner gefunden wird, ist der Rückgabewert FALSE.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |