PFN_IMPORT_PUBLIC_KEY_INFO_EX2_FUNC fonction de rappel (wincrypt.h)

Article
08/27/2023

La fonction de rappel PFN_IMPORT_PUBLIC_KEY_INFO_EX2_FUNC est appelée par CryptImportPublicKeyInfoEx2 pour décoder l’identificateur d’algorithme de clé publique , charger le fournisseur d’algorithme et importer la paire de clés.

Syntaxe

PFN_IMPORT_PUBLIC_KEY_INFO_EX2_FUNC PfnImportPublicKeyInfoEx2Func;

BOOL PfnImportPublicKeyInfoEx2Func(
  [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

Pointeur vers 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.

[in] pvAuxInfo

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

[out] phKey

Pointeur vers une variable BCRYPT_KEY_HANDLE qui reçoit le handle de la clé importée.

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.

Remarques

Vous pouvez utiliser les fonctions de support OID pour déployer cette fonction de rappel. Wincrypt.h définit la constante suivante à cet effet.

Constant	Définition
CRYPT_OID_IMPORT_PUBLIC_KEY_INFO_EX2_FUNC	« CryptDllImportPublicKeyInfoEx2 »

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wincrypt.h

Partager via