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 des SSL-Protokollanbieters instance.

hKey [ein, aus]

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 .

pcbResult [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 der höheren 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_ALERT 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 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.

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