SslGenerateSessionKeys-Funktion

Die SslGenerateSessionKeys-Funktion generiert einen Satz von SSL-Sitzungsschlüsseln ( Secure Sockets Layer Protocol ).

Syntax

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
);

Parameter

hSslProvider [in]

Das Handle für den SSL-Protokollanbieter instance.

hMasterKey [in]

Das Handle für das master Schlüsselobjekt.

phReadKey [out]

Ein Zeiger auf das zurückgegebene Lesetastenhandle.

phWriteKey [out]

Ein Zeiger auf das zurückgegebene Schreibschlüsselhandle.

pParameterList [in]

Ein Zeiger auf ein Array von NCryptBuffer-Puffern , die Informationen enthalten, die im Rahmen des Schlüsselaustauschvorgangs verwendet werden. Der genaue Satz von Puffern hängt vom verwendeten Protokoll und der verwendeten Verschlüsselungssammlung ab. Die Liste enthält mindestens Puffer, die die vom Client und Server bereitgestellten Zufallswerte enthalten.

dwFlags [in]

Dieser Parameter ist für die zukünftige Verwendung reserviert.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie null zurück.

Wenn die Funktion fehlschlägt, wird ein Fehlerwert ungleich null zurückgegeben.

Mögliche Rückgabecodes sind u. a. die folgenden:

Rückgabecode/-wert	Beschreibung
NTE_NO_MEMORY 0x8009000EL	Es ist nicht genügend Arbeitsspeicher verfügbar, um die erforderlichen Puffer zuzuweisen.
NTE_INVALID_HANDLE 0x80090026L	Einer der bereitgestellten Handles ist ungültig.
NTE_INVALID_PARAMETER 0x80090027L	Der parameter phReadKey oder phWriteKey ist NULL.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Sslprovider.h
DLL	Ncrypt.dll