SslLookupCipherLengths-Funktion

Artikel
06/12/2023

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.

Rückgabecode/-wert	Beschreibung
NTE_INVALID_HANDLE 0x80090026L	Der hSslProvider-Parameter enthält einen ungültigen Zeiger.
NTE_INVALID_PARAMETER 0x80090027L	Der pCipherLengths-Parameter ist auf NULL festgelegt, oder die vom cbCipherLengths angegebene Pufferlänge ist zu kurz.
NTE_BAD_FLAGS 0x80090009L	Der dwFlags-Parameter muss auf 0 festgelegt werden.

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

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

Freigeben über