Condividi tramite


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