Fonction CertGetIntendedKeyUsage (wincrypt.h)

  • Article

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