CertGetValidUsages-Funktion (wincrypt.h)

Die CertGetValidUsages-Funktion gibt ein Array von Verwendungen zurück, die aus der Schnittmenge der gültigen Verwendungen für alle Zertifikate in einem Array von Zertifikaten bestehen.

Syntax

BOOL CertGetValidUsages(
  [in]      DWORD          cCerts,
  [in]      PCCERT_CONTEXT *rghCerts,
  [out]     int            *cNumOIDs,
  [out]     LPSTR          *rghOIDs,
  [in, out] DWORD          *pcbOIDs
);

Parameter

[in] cCerts

Die Anzahl der Zertifikate im zu überprüfenden Array.

[in] rghCerts

Ein Array von Zertifikaten, die auf gültige Verwendung überprüft werden sollen.

[out] cNumOIDs

Die Anzahl der gültigen Verwendungen, die als Schnittmenge der gültigen Verwendungen aller Zertifikate im Array gefunden wurden. Wenn alle Zertifikate für alle Verwendungen gültig sind, wird cNumOIDs auf negativ (–1) festgelegt.

[out] rghOIDs

Ein Array der Objektbezeichner (Object Identifiers , OIDs) der gültigen Verwendungen, die von allen Zertifikaten im rghCerts-Array gemeinsam genutzt werden. Dieser Parameter kann NULL sein, um die Größe dieser Struktur für Speicherbelegungszwecke festzulegen. Weitere Informationen finden Sie unter Abrufen von Daten unbekannter Länge.

[in, out] pcbOIDs

Ein Zeiger auf einen DWORD-Wert , der die Größe des rghOIDs-Arrays und der Zeichenfolgen in Bytes angibt, auf die verwiesen wird. Wenn die Funktion zurückgibt, enthält der DWORD-Wert die Anzahl der Bytes, die für das Array benötigt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Anforderungen

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