Fonction CertSetEnhancedKeyUsage (wincrypt.h)

  • Article

La fonction CertSetEnhancedKeyUsage définit la propriété EKU ( Enhanced Key Usage ) pour le certificat. L’utilisation de cette fonction remplace toutes les EKU associées au certificat. Pour ajouter une seule utilisation des références EKU sans modifier les utilisations existantes, utilisez CertAddEnhancedKeyUsageIdentifier. Pour supprimer une seule utilisation de la référence EKU, utilisez CertRemoveEnhancedKeyUsageIdentifier.

Syntaxe

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

Paramètres

[in] pCertContext

Pointeur vers le CERT_CONTEXT du certificat spécifié.

[in] pUsage

Pointeur vers une structure de CERT_ENHKEY_USAGE (équivalente à une structure de CTL_USAGE) qui contient un tableau d’identificateurs d’objets EKU (OID) à définir en tant que propriétés étendues du certificat.

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro (TRUE).

Si la fonction échoue, elle retourne zéro (FALSE). Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wincrypt.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll

Voir aussi

CertGetEnhancedKeyUsage

Fonctions d’utilisation des clés améliorées