SslDecryptPacket-Funktion
Die SslDecryptPacket-Funktion entschlüsselt ein einzelnes SSL-Paket (Secure Sockets Layer Protocol).
Syntax
SECURITY_STATUS WINAPI SslDecryptPacket(
_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 dwFlags
);
Parameter
-
hSslProvider [ In]
-
Das Handle der SSL-Protokollanbieterinstanz.
-
hKey [ in, out]
-
Das Handle für den Schlüssel, der zum Entschlüsseln des Pakets verwendet wird.
-
pbInput [ In]
-
Ein Zeiger auf den Puffer, der das zu entschlüsselnde Paket enthält.
-
cbInput [ In]
-
Die Länge des pbInput-Puffers in Bytes.
-
pbOutput [ out]
-
Ein Zeiger auf einen Puffer, der das entschlüsselte Paket enthalten soll.
-
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.
-
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. |
Bemerkungen
Die Länge des Pakets kann 0 (null) sein, z. B. wenn eine "HelloRequest"-Nachricht entschlüsselt wird.
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 |
|