Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|