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 |
---|---|
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um die erforderlichen Puffer zuzuweisen. |
|
Einer der bereitgestellten Handles ist ungültig. |
|
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 |
|
DLL |
|