Funzione SslGetKeyProperty

La funzione SslGetKeyProperty recupera il valore di una proprietà denominata per un oggetto chiave del provider SSL (Secure Sockets Layer Protocol ).

Sintassi

SECURITY_STATUS WINAPI SslGetKeyProperty(
  _In_  NCRYPT_KEY_HANDLE hKey,
  _In_  LPCWSTR           pszProperty,
  _Out_ PBYTE             ppbOutput,
  _Out_ DWORD             *pcbOutput,
  _In_  DWORD             dwFlags
);

Parametri

hKey [in]

Handle del provider SSL.

pszProperty [in]

Puntatore a una stringa Unicode con terminazione null contenente il nome della proprietà da recuperare. Può trattarsi di uno degli identificatori di proprietà di archiviazione chiavi predefiniti o di un identificatore di proprietà personalizzato.

ppbOutput [out]

Puntatore a 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 .

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_INVALID_HANDLE 0x80090026L	Uno degli handle forniti 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