Fonction CertGetIntendedKeyUsage (wincrypt.h)

Article
03/06/2024

La fonction CertGetIntendedKeyUsage acquiert les octets d’utilisation de clé prévus à partir d’un certificat. L’utilisation de la clé prévue peut être dans l’extension szOID_KEY_USAGE (« 2.5.29.15 ») ou szOID_KEY_ATTRIBUTES (« 2.5.29.2 »).

Syntaxe

BOOL CertGetIntendedKeyUsage(
  [in]  DWORD      dwCertEncodingType,
  [in]  PCERT_INFO pCertInfo,
  [out] BYTE       *pbKeyUsage,
  [in]  DWORD      cbKeyUsage
);

Paramètres

[in] dwCertEncodingType

Spécifie le type d’encodage utilisé. Il est toujours acceptable de spécifier les types d’encodage de certificat et de message en les combinant avec une opération OR au niveau du bit, comme illustré dans l’exemple suivant :

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING types d’encodage actuellement définis sont les suivants :

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pCertInfo

Pointeur vers CERT_INFO structure du certificat spécifié.

[out] pbKeyUsage

Pointeur vers une mémoire tampon pour recevoir l’utilisation de la clé prévue. La liste suivante présente les valeurs actuellement définies. Ces opérations peuvent être combinées à l’aide d’opérations OR au niveau du bit.

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_DIGITAL_SIGNATURE_KEY_USAGE
CERT_KEY_AGREEMENT_KEY_USAGE
CERT_KEY_CERT_SIGN_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE
CERT_NON_REPUDIATION_KEY_USAGE
CERT_OFFLINE_CRL_SIGN_KEY_USAGE

[in] cbKeyUsage

Taille, en octets, de la mémoire tampon pointée par pbKeyUsage. Actuellement, l’utilisation de la clé prévue occupe 1 ou 2 octets de données.

Valeur retournée

Si le certificat n’a pas d’octets d’utilisation de clé prévus, FALSE est retourné et pbKeyUsage est mis à zéro. Sinon, TRUE est retourné et jusqu’à cbKeyUsage nombre d’octets sont copiés dans pbKeyUsage. Tous les octets restants non copiés sont mis à zéro.

GetLastError retourne zéro si aucune des extensions requises n’est trouvée.

Si la fonction échoue, GetLastError peut renvoyer une erreur d’encodage/décodage ASN.1 ( Abstract Syntax Notation One ). Pour plus d’informations sur ces erreurs, consultez Valeurs de retour d’encodage/décodage ASN.1.

Configuration requise

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

Voir aussi

Gestion des données Functions

Partager via