Fonction CryptImportPublicKeyInfoEx2 (wincrypt.h)

  • Article

La fonction CryptImportPublicKeyInfoEx2 importe une clé publique dans le fournisseur asymétrique CNG qui correspond à l’identificateur d’objet de clé publique (OID) et retourne un handle CNG à la clé.

Syntaxe

BOOL CryptImportPublicKeyInfoEx2(
  [in]  DWORD                 dwCertEncodingType,
  [in]  PCERT_PUBLIC_KEY_INFO pInfo,
  [in]  DWORD                 dwFlags,
  [in]  void                  *pvAuxInfo,
  [out] BCRYPT_KEY_HANDLE     *phKey
);

Paramètres

[in] dwCertEncodingType

Type d’encodage de certificat utilisé pour chiffrer l’objet. L’identificateur de type d’encodage de message, contenu dans le mot élevé de cette valeur, est ignoré par cette fonction.

Ce paramètre peut être le type d’encodage de certificat actuellement défini ci-dessous.

Valeur Signification
X509_ASN_ENCODING
1 (0x1)
 Spécifie l’encodage du certificat X.509 .

[in] pInfo

Adresse d’une structure de CERT_PUBLIC_KEY_INFO qui contient les informations de clé publique à importer dans le fournisseur.

[in] dwFlags

Ensemble d’indicateurs qui modifient le comportement de cette fonction. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

Valeur Signification
CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
 Ignore les clés publiques dans le groupe CRYPT_PUBKEY_ALG_OID_GROUP_ID qui sont explicitement marquées avec l’indicateur CRYPT_OID_PUBKEY_ENCRYPT_ONLY_FLAG.
CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG
 Ignore les clés publiques du groupe CRYPT_PUBKEY_ALG_OID_GROUP_ID qui sont explicitement marquées avec l’indicateur CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG.
 

Ces indicateurs sont transmis dans le paramètre dwKeyType de la fonction CryptFindOIDInfo lors du mappage de l’identificateur d’objet de clé publique à l’identificateur d’algorithme de clé publique CNG correspondant.

[in] pvAuxInfo

Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur NULL.

[out] phKey

Adresse d’une variable BCRYPT_KEY_HANDLE qui reçoit le handle de la clé importée.

Lorsque ce handle n’est plus nécessaire, vous devez le libérer en appelant la fonction BCryptDestroyKey .

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. Les codes d’erreur possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour Description
ERROR_FILE_NOT_FOUND
 Une fonction d’importation qui peut être installée ou inscrite est introuvable pour les paramètres dwCertEncodingType et pInfo spécifiés.
E_INVALIDARG
 Un ou plusieurs paramètres ne sont pas valides.

Configuration requise

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

Voir aussi

CERT_PUBLIC_KEY_INFO