Funzione SslEnumProtocolProviders

Articolo
06/12/2023

La funzione SslEnumProtocolProviders restituisce una matrice di provider di protocolli SSL (Secure Sockets Layer) installati.

Sintassi

SECURITY_STATUS WINAPI SslEnumProtocolProviders(
  _Out_ DWORD              *pdwProviderCount,
  _Out_ NCryptProviderName **ppProviderList,
  _In_  DWORD              dwFlags
);

Parametri

pdwProviderCount [out]: Puntatore a un valore DWORD per ricevere il numero di provider di protocollo restituiti.
ppProviderList [out]: Puntatore a un buffer che riceve la matrice di strutture NCryptProviderName .
dwFlags [in]: Questo parametro è riservato per usi futuri.

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_BAD_FLAGS 0x80090009L	Il parametro dwFlags non è zero.
NTE_NO_MEMORY 0x8009000EL	Memoria insufficiente per allocare i buffer necessari.
NTE_INVALID_PARAMETER 0x80090027L	Il parametro pdwProviderCount o ppProviderList è NULL.

Commenti

Al termine dell'uso della matrice di strutture NCryptProviderName , chiamare la funzione SslFreeBuffer per liberare la matrice.

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

Condividi tramite