SslDecryptPacket-Funktion

Artikel
06/12/2023

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 des SSL-Protokollanbieters instance.
hKey [ein, aus]: 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 enthält.
cbOutput [in]: Die Länge (Bytes) des pbOutput-Puffers .
pcbResult [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 null zurück.

Wenn die Funktion fehlschlägt, gibt sie einen fehlerfreien Wert zurück.

Mögliche Rückgabecodes umfassen folgendes, sind aber nicht darauf beschränkt.

Rückgabecode/-wert	Beschreibung
NTE_INVALID_HANDLE 0x80090026L	Eines der bereitgestellten Handles ist ungültig.

Bemerkungen

Die Länge des Pakets kann 0 sein, z. B. wenn eine "HelloRequest"-Nachricht entschlüsselt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Sslprovider.h
DLL	Ncrypt.dll

Freigeben über