SslLookupCipherLengths-Funktion

Die SslLookupCipherLengths-Funktion gibt eine NCRYPT_SSL_CIPHER_LENGTHS-Struktur zurück, die die Header- und Trailerlängen des Eingabeprotokolls, der Verschlüsselungssuite und des Schlüsseltyps enthält.

Syntax

SECURITY_STATUS WINAPI SslLookupCipherLengths(
  _In_  NCRYPT_PROV_HANDLE        hSslProvider,
  _In_  DWORD                     dwProtocol,
  _In_  DWORD                     dwCipherSuite,
  _In_  DWORD                     dwKeyType,
  _Out_ NCRYPT_SSL_CIPHER_LENGTHS *pCipherLengths,
  _In_  DWORD                     cbCipherLengths,
  _In_  DWORD                     dwFlags
);

Parameter

hSslProvider [in]

Das Handle des SSL-Protokollanbieters (Secure Sockets Layer Protocol) instance.

dwProtocol [in]

Einer der Werte des CNG-SSL-Anbieterprotokoll-Bezeichners .

dwCipherSuite [in]

Einer der CNG SSL Provider Cipher Suite Identifier-Werte .

dwKeyType [in]

Einer der Werte für den Schlüsseltypbezeichner des CNG-SSL-Anbieters . Legen Sie für Schlüsseltypen, die keine Elliptikkurvenkryptografie (ECC) sind, diesen Parameter auf 0 fest.

pCipherLengths [out]

Ein Zeiger auf einen Puffer, um die NCRYPT_SSL_CIPHER_LENGTHS Struktur zu empfangen.

cbCipherLengths [in]

Die Länge des Puffers in Bytes, auf den der pCipherLengths-Parameter verweist.

dwFlags [in]

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf null festgelegt werden.

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.

Bemerkungen

Die SslLookupCipherLengths-Funktion wird für Transport Layer Security Protocol (TLS) 1.1 oder höher aufgerufen, um die Header- und Trailerlängen für das angeforderte Protokoll, die Verschlüsselungssuite und den Schlüsseltyp abzufragen.

Anforderungen