FreeCryptProvFromCertEx fonction)

La fonction FreeCryptProvFromCertEx libère le descripteur d’un fournisseur de services de chiffrement (CSP) ou d’une clé Cryptography API : Next Generation (CNG).

Notes

Cette fonction n’a aucun fichier d’en-tête ou bibliothèque d’importation associé. 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 à Mssign32.dll.

Syntaxe

void WINAPI FreeCryptProvFromCertEx(
  _In_     BOOL                            fAcquired,
  _In_     HCRYPTPROV_OR_NCRYPT_KEY_HANDLE hProv,
           DWORD                           dwKeySpec,
  _In_opt_ LPWSTR                          pwszCapiProvider,
  _In_     DWORD                           dwProviderType,
  _In_opt_ LPWSTR                          pwszTmpContainer
);

Paramètres

fAcquired [ dans]

Valeur qui spécifie si le handle du fournisseur a été acquis à partir du certificat.

hProv [ dans]

Handle vers un CSP CAPICOM ou un handle vers une clé CNG.

dwKeySpec

Adresse d’une variable DWORD qui reçoit des informations supplémentaires sur la clé. Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
au niveau de _ KEYexchange
La paire de clés est une paire d’échange de clés.
à la _ signature
La paire de clés est une paire de signatures.
spécification de clé de certificat _ NCRYPT _ _
La clé est une clé CNG.
Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge.

pwszCapiProvider [ dans, facultatif]

Pointeur vers une chaîne terminée par le caractère null pour le nom du fournisseur.

dwProviderType [ dans]

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

pwszTmpContainer [ dans, facultatif]

Pointeur vers une chaîne se terminant par un caractère null pour le nom du conteneur de clé temporaire.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
applications de [ bureau Windows 7 uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 R2, [ applications de bureau uniquement]
DLL
Mssign32.dll