Funzione SslGenerateSessionKeys

La funzione SslGenerateSessionKeys genera un set di chiavi di sessione SSL ( Secure Sockets Layer Protocol ).

Sintassi

SECURITY_STATUS WINAPI SslGenerateSessionKeys(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hMasterKey,
  _Out_ NCRYPT_KEY_HANDLE  *phReadKey,
  _Out_ NCRYPT_KEY_HANDLE  *phWriteKey,
  _In_  PNCryptBufferDesc  pParameterList,
  _In_  DWORD              dwFlags
);

Parametri

hSslProvider [in]

Handle all'istanza del provider di protocolli SSL.

hMasterKey [in]

Handle per l'oggetto chiave master .

phReadKey [out]

Puntatore all'handle chiave di lettura restituito.

phWriteKey [out]

Puntatore all'handle di chiave di scrittura restituito.

pParameterList [in]

Puntatore a una matrice di buffer NCryptBuffer che contengono informazioni usate come parte dell'operazione di scambio delle chiavi. Il set preciso di buffer dipende dal protocollo e dalla suite di crittografia usata. Al minimo, l'elenco conterrà buffer che contengono i valori casuali del client e del server.

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	Uno degli handle forniti non è valido.
NTE_INVALID_PARAMETER 0x80090027L	Il parametro phReadKey o phWriteKey è Null.

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