GetCryptProvFromCert, fonction

Important

Cette API est déconseillée. Microsoft peut supprimer cette API dans les versions ultérieures.

 

La fonction GetCryptProvFromCert obtient un handle à un fournisseur de services de chiffrement (CSP) et une spécification de clé pour un contexte de certificat . Utilisez cette fonction pour accéder à la clé privée de l’émetteur de certificat.

Notes

Cette fonction n’a pas de fichier d’en-tête associé ni de bibliothèque d’importation. Pour appeler cette fonction, vous devez créer un fichier d’en-tête défini par l’utilisateur et utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Mssign32.dll.

 

Syntaxe

BOOL WINAPI GetCryptProvFromCert(
  _In_      HWND           hwnd,
  _In_      PCCERT_CONTEXT pCert,
  _Out_     HCRYPTPROV     *phCryptProv,
  _Out_     DWORD          *pdwKeySpec,
  _In_      BOOL           *pfDidCryptAcquire,
  _Out_opt_ LPWSTR         *ppwszTmpContainer,
  _Out_opt_ LPWSTR         *ppwszProviderName,
  _Out_     DWORD          *pdwProviderType
);

Paramètres

hwnd [in]

Handle de la fenêtre à utiliser comme propriétaire des boîtes de dialogue affichées. Ce membre n’est actuellement pas utilisé et est ignoré. Il est sûr de passer null pour ce paramètre.

pCert [in]

Pointeur vers une structure de CERT_CONTEXT pour le certificat.

phCryptProv [out]

Pointeur vers une structure HCRYPTPROV qui est un handle du fournisseur de solutions Cloud.

pdwKeySpec [out]

Spécification de la clé privée à récupérer. Les valeurs possibles incluent AT_KEYEXCHANGE ou AT_SIGNATURE.

pfDidCryptAcquire [in]

Valeur qui spécifie si la fonction a acquis le handle du fournisseur en fonction du certificat.

ppwszTmpContainer [out, facultatif]

Adresse d’un pointeur vers une chaîne terminée par null pour le nom du conteneur de clé temporaire. La fonction GetCryptProvFromCert fournit et initialise le conteneur temporaire. Lors de l’appel de GetCryptProvFromCert, l’adresse doit pointer vers une valeur NULL .

ppwszProviderName [out, facultatif]

Adresse d’un pointeur vers une chaîne terminée par null pour le nom du fournisseur. La fonction GetCryptProvFromCert retourne le nom du fournisseur. Lors de l’appel de GetCryptProvFromCert, l’adresse doit pointer vers une valeur NULL .

pdwProviderType [out]

Spécifie le type csp. Il peut s’agir de zéro ou d’un des types de fournisseurs de chiffrement. Si ce membre est égal à zéro, le conteneur de clés est l’un des fournisseurs de stockage de clés CNG.

Valeur retournée

En cas de réussite, cette fonction retourne TRUE. La fonction GetCryptProvFromCert retourne FALSE en cas d’échec.

Notes

L’outil MakeCert appelle GetCryptProvFromCert lorsque vous l’appelez à l’aide de l’option de ligne de commande -is .

Si le paramètre pfDidCryptAcquire a la valeur TRUE, la fonction définit les paramètres phCryptProv, pdwKeySpec et pdwProviderType sur les valeurs du fournisseur.

Une fois que vous avez terminé d’utiliser le csp, libérez-le en appelant la fonction FreeCryptProvFromCert .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
DLL	Mssign32.dll