Funzione SslOpenProvider

La funzione SslOpenProvider apre un handle per il provider di protocollo SSL ( Secure Sockets Layer Protocol) specificato.

Sintassi

SECURITY_STATUS WINAPI SslOpenProvider(
  _Out_ NCRYPT_PROV_HANDLE *phSslProvider,
  _In_  LPCWSTR            pszProviderName,
  _In_  DWORD              dwFlags
);

Parametri

phSslProvider [out]

Indirizzo di un NCRYPT_PROV_HANDLE in cui scrivere l'handle del provider.

Al termine dell'uso dell'handle, è consigliabile liberarlo chiamando la funzione SslFreeObject .

pszProviderName [in]

Puntatore a una stringa Unicode contenente il nome del provider. Se il valore di questo parametro è NULL, viene restituito un handle per il MS_SCHANNEL_PROVIDER .

dwFlags [in]

Questo parametro è riservato per uso futuro e deve essere impostato su zero.

Valore restituito

Se la funzione ha esito positivo, restituisce zero.

Se la funzione ha esito negativo, restituisce un valore di errore diverso da zero.

I codici restituiti possibili includono, a titolo esemplificativo, quanto segue.

Codice/valore restituito	Descrizione
NTE_INVALID_HANDLE 0x80090026L	Uno degli handle forniti non è valido.
NTE_INVALID_PARAMETER 0x80090027L	Il parametro phSslProvider o ppProviderList è NULL.
STATUS_NO_MEMORY 0xC0000017L	Memoria insufficiente per allocare i buffer necessari.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Sslprovider.h
DLL	Ncrypt.dll