Fonction FreeCryptProvFromCertEx

  • Article

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

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 lier dynamiquement à 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 [in]

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

hProv [in]

Un handle pour un fournisseur de solutions cloud CAPICOM ou un handle pour 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
AT_KEYEXCHANGE
 La paire de clés est une paire d’échange de clés.
AT_SIGNATURE
 La paire de clés est une paire de signatures.
CERT_NCRYPT_KEY_SPEC
 La clé est une clé CNG.
Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge.

 

pwszCapiProvider [in, facultatif]

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

dwProviderType [in]

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.

pwszTmpContainer [in, facultatif]

Pointeur vers une chaîne terminée par null pour le nom du conteneur de clé temporaire.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Spécifications

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