CertSetEnhancedKeyUsage-Funktion (wincrypt.h)

  • Artikel

Die CertSetEnhancedKeyUsage-Funktion legt die EKU-Eigenschaft ( Enhanced Key Usage ) für das Zertifikat fest. Die Verwendung dieser Funktion ersetzt alle EKUs, die dem Zertifikat zugeordnet sind. Verwenden Sie CertAddEnhancedKeyUsageIdentifier, um eine einzelne EKU-Nutzung hinzuzufügen, ohne vorhandene Nutzungen zu ändern. Verwenden Sie CertRemoveEnhancedKeyUsageIdentifier, um eine einzelne EKU-Verwendung zu löschen.

Syntax

BOOL CertSetEnhancedKeyUsage(
  [in] PCCERT_CONTEXT     pCertContext,
  [in] PCERT_ENHKEY_USAGE pUsage
);

Parameter

[in] pCertContext

Ein Zeiger auf die CERT_CONTEXT des angegebenen Zertifikats.

[in] pUsage

Zeiger auf eine CERT_ENHKEY_USAGE-Struktur (entspricht einer CTL_USAGE-Struktur ), die ein Array von EKU-Objektbezeichnern (OIDs) enthält, die als erweiterte Eigenschaften des Zertifikats festgelegt werden sollen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ungleich null (TRUE) zurück.

Wenn die Funktion fehlschlägt, gibt sie null (FALSE) zurück. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

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

CertGetEnhancedKeyUsage

Erweiterte Schlüsselverwendungsfunktionen