Funzione SslGetProviderProperty

Articolo
06/13/2023

La funzione SslGetProviderProperty recupera il valore di una proprietà del provider specificata.

Sintassi

SECURITY_STATUS WINAPI SslGetProviderProperty(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _In_    LPCWSTR            pszProperty,
  _Out_   PBYTE              ppbOutput,
  _Out_   DWORD              *pcbOutput,
  _Inout_ PVOID              *ppEnumState,
  _In_    DWORD              dwFlags
);

Parametri

hSslProvider [in]

Handle del provider SSL (Secure Sockets Layer Protocol ) per cui recuperare la proprietà.

pszProperty [in]

Puntatore a una stringa Unicode con terminazione null contenente il nome della proprietà da recuperare.

ppbOutput [out]

Indirizzo di un buffer che riceve il valore della proprietà.

Il chiamante della funzione deve liberare questo buffer chiamando la funzione SslFreeBuffer .

pcbOutput [out]

Dimensioni, in byte, del buffer pbOutput .

ppEnumState [in, out]

Indirizzo di un puntatore VOID che riceve informazioni sullo stato di enumerazione usate nelle chiamate successive a questa funzione. Queste informazioni hanno significato solo per il provider SSL ed è opaco al chiamante. Il provider SSL usa queste informazioni per determinare quale elemento è successivo nell'enumerazione. Se la variabile puntata da questo parametro contiene NULL, l'enumerazione viene avviata dall'inizio.

Il chiamante della funzione deve liberare questa memoria chiamando la funzione SslFreeBuffer .

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, ma non sono limitati a, i seguenti.

Codice/valore restituito	Descrizione
NTE_NO_MEMORY 0x8009000EL	Memoria insufficiente è disponibile per allocare i buffer necessari.
NTE_INVALID_HANDLE 0x80090026L	L'handle hSslProvider non è valido.
NTE_INVALID_PARAMETER 0x80090027L	Uno dei parametri forniti non è valido.

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

Share via