Funzione PvkGetCryptProv

Articolo
06/13/2023

Importante

Questa API è deprecata. Microsoft può rimuovere questa API nelle versioni future.

La funzione PvkGetCryptProv ottiene un handle a un provider di servizi di crittografia (CSP) in base a un file di chiave privata o a un nome del contenitore di chiavi.

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

HRESULT WINAPI PvkGetCryptProv(
  _In_      HWND       hwnd,
  _In_      LPCWSTR    pwszCaption,
  _In_      LPCWSTR    pwszCapiProvider,
  _In_      DWORD      dwProviderType,
  _In_      LPCWSTR    pwszPvkFile,
  _In_      LPCWSTR    pwszKeyContainerName,
  _Out_     DWORD      *pdwKeySpec,
  _Out_opt_ LPWSTR     *ppwszTmpContainer,
  _Out_     HCRYPTPROV *phCryptProv
);

Parametri

hwnd [in]: Se è necessaria una password per decrittografare il file di chiave privata, questo parametro è un handle per l'elemento padre della finestra di dialogo password; in caso contrario, è NULL.
pwszCaption [in]: Puntatore a una stringa con terminazione null per la finestra di dialogo didascalia.
pwszCapiProvider [in]: Puntatore a una stringa con terminazione Null per il nome CSP.
dwProviderType [in]: Valore DWORD che rappresenta il tipo di provider crittografico. Per altre informazioni, vedere Tipi di provider crittografici.
pwszPvkFile [in]: Puntatore a una stringa con terminazione null contenente il nome di un file di chiave privata.
pwszKeyContainerName [in]: Puntatore a una stringa con terminazione null per il nome del contenitore della chiave privata.
pdwKeySpec [out]: Puntatore a un valore DWORD per il tipo di chiave del contenitore restituito con phCryptProv e ppwszTmpContainer.
ppwszTmpContainer [out, facoltativo]: Indirizzo di un puntatore a una stringa con terminazione Null per il nome del contenitore di chiavi temporanee. La funzione PvkGetCryptProv fornisce e inizializza il contenitore temporaneo. Quando si chiama PvkGetCryptProv, l'indirizzo deve puntare a un valore NULL .
phCryptProv [out]: Puntatore a un handle per il CSP.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

La funzione PvkGetCryptProv tenta prima di tutto di ottenere l'handle del provider dal nome del contenitore chiave specificato dal parametro pwszKeyContainerName . Se si passa NULL per il parametro pwszKeyContainerName , PvkGetCryptProv tenta di ottenere il provider dal file di chiave privata specificato nel parametro pwszPvkFile .

Al termine dell'uso del provider CSP, liberare l'handle del provider e il contenitore di chiavi temporanee chiamando la funzione PvkFreeCryptProv .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
DLL	Mssign32.dll