SslEncryptPacket-Funktion
Die SslEncryptPacket-Funktion verschlüsselt ein einzelnes SSL-Paket (Secure Sockets Layer Protocol).
Syntax
SECURITY_STATUS WINAPI SslEncryptPacket(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_Inout_ NCRYPT_KEY_HANDLE hKey,
_In_ PBYTE *pbInput,
_In_ DWORD cbInput,
_Out_ PBYTE pbOutput,
_In_ DWORD cbOutput,
_Out_ DWORD *pcbResult,
_In_ ULONGLONG SequenceNumber,
_In_ DWORD dwContentType,
_In_ DWORD dwFlags
);
Parameter
-
hSslProvider [ In]
-
Das Handle der SSL-Protokollanbieterinstanz.
-
hKey [ in, out]
-
Das Handle für den Schlüssel, der zum Verschlüsseln des Pakets verwendet wird.
-
pbInput [ In]
-
Ein Zeiger auf den Puffer, der das zu verschlüsselnde Paket enthält.
-
cbInput [ In]
-
Die Länge des pbInput-Puffers in Bytes.
-
pbOutput [ out]
-
Ein Zeiger auf einen Puffer zum Empfangen des verschlüsselten Pakets.
-
cbOutput [ In]
-
Die Länge (Bytes) des pbOutput-Puffers.
-
resultsResult [ out]
-
Die Anzahl der Bytes, die in den pbOutput-Puffer geschrieben wurden.
-
SequenceNumber [ In]
-
Die Sequenznummer, die diesem Paket entspricht.
-
dwContentType [ In]
-
Der Inhaltstyp, der diesem Paket entspricht, der das Protokoll auf höherer Ebene angibt, das zum Verarbeiten des eingeschlossenen Pakets verwendet wird.
Wert Bedeutung - CT _ CHANGE _ CIPHER _ SPEC
- 20
Gibt eine Änderung der Verschlüsselungsstrategie an. - CT _ WARNUNG
- 21
Gibt an, dass das eingeschlossene Paket eine Warnung enthält. - CT _ HANDSHAKE
- 22
Gibt an, dass das eingeschlossene Paket Teil des Handshakeprotokolls ist. - CT _ APPLICATIONDATA
- 23
Gibt an, dass das Paket Anwendungsdaten enthält. -
dwFlags [ In]
-
Dieser Parameter ist für die zukünftige Verwendung reserviert.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie 0 (null) zurück.
Wenn die Funktion fehlschlägt, wird ein Fehlerwert ungleich 0 (null) zurückgegeben.
Mögliche Rückgabecodes sind u. a. folgende.
| Rückgabecode/-wert | Beschreibung |
|---|---|
|
Einer der bereitgestellten Handles ist ungültig. |
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|
| DLL |
|