Condividi tramite


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