Funzione FreeCryptProvFromCertEx

  • Articolo

La funzione FreeCryptProvFromCertEx rilascia l'handle a un provider di servizi di crittografia (CSP) o a un'API di crittografia: chiave CNG (Next Generation).

Nota

Questa funzione non ha alcun file di intestazione associato o una libreria di importazione. Per chiamare questa funzione, è necessario creare un file di intestazione definito dall'utente e usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Mssign32.dll.

 

Sintassi

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
);

Parametri

fAcquired [in]

Valore che specifica se l'handle del provider è stato acquisito dal certificato.

hProv [in]

Handle a un CSP CAPICOM o a un handle a una chiave CNG.

dwKeySpec

Indirizzo di una variabile DWORD che riceve informazioni aggiuntive sulla chiave. Questo può essere uno dei valori seguenti.

Valore Significato
AT_KEYEXCHANGE
 La coppia di chiavi è una coppia di scambio di chiavi.
AT_SIGNATURE
 La coppia di chiavi è una coppia di firme.
CERT_NCRYPT_KEY_SPEC
 La chiave è una chiave CNG.
Windows Server 2003 e Windows XP: Questo valore non è supportato.

 

pwszCapiProvider [in, facoltativo]

Puntatore a una stringa con terminazione null per il nome del provider.

dwProviderType [in]

Specifica il tipo CSP. Questo può essere zero o uno dei tipi di provider crittografici. Se questo membro è zero, il contenitore della chiave è uno dei provider di archiviazione delle chiavi CNG.

pwszTmpContainer [in, facoltativo]

Puntatore a una stringa con terminazione null per il nome del contenitore di chiavi temporanee.

Valore restituito

Questa funzione non restituisce un valore.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 7 [solo app desktop]
Server minimo supportato
 Windows Server 2008 R2 [solo app desktop]
DLL
Mssign32.dll