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

Weitere Informationen

CTL_CONTEXT

CertEnumSubjectInSortedCTL

Wartungsfunktionen für Zertifikat- und Zertifikatspeicher