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
NTE _ UNGÜLTIGES _ HANDLE
0x80090026L
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
Sslprovider.h
DLL
Ncrypt.dll