Fonction CryptImportPublicKeyInfoEx2 (wincrypt.h)

Article
07/16/2024

La fonction CryptImportPublicKeyInfoEx2 importe une clé publique dans le fournisseur asymétrique CNG qui correspond à la clé publique identificateur d’objet (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

Le type d’encodage de certificat utilisé pour chiffrer l’objet. Le type d’encodage de message identificateur, contenu dans le WORD é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 encodage de certificat X.509.

[in] pInfo

Adresse d’une structure 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 de CRYPT_OID_PUBKEY_ENCRYPT_ONLY_FLAG.
CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG	Ignore les clés publiques dans le groupe CRYPT_PUBKEY_ALG_OID_GROUP_ID qui sont explicitement marquées avec l’indicateur de CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG.

Ces indicateurs sont passés 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é pour 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 de retour

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, mais ne sont pas limités à, les éléments suivants.

Retourner le code	Description
ERROR_FILE_NOT_FOUND	Impossible de trouver une fonction d’importation qui peut être installée ou inscrite pour les paramètres dwCertEncodingType spécifiés et paramètres de pInfo.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	wincrypt.h
bibliothèque	Crypt32.lib
DLL	Crypt32.dll

Voir aussi

CERT_PUBLIC_KEY_INFO

Partager via