SslLookupCipherLengths-Funktion

Die SslLookupCipherLengths-Funktion gibt eine NCRYPT _ SSL _ CIPHER _ LENGTHS-Struktur zurück, die die Header- und Nachspannlängen des Eingabeprotokolls, der Verschlüsselungssammlung 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 der SSL-Protokollanbieterinstanz (Secure Sockets Layer Protocol).

dwProtocol [ In]

Einer der CNG SSL Provider Protocol Identifier-Werte.

dwCipherSuite [ In]

Einer der CNG SSL Provider Cipher Suite Identifier-Werte.

dwKeyType [ In]

Einer der CNG SSL Provider Key Type Identifier-Werte. Legen Sie für Schlüsseltypen, bei denen es sich nicht um ECC (Elliptic Curve Cryptography) handelt, diesen Parameter auf 0 (null) fest.

pCipherLengths [ out]

Ein Zeiger auf einen Puffer zum Empfangen der NCRYPT _ SSL _ CIPHER _ LENGTHS-Struktur.

cbCipherLengths [ In]

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

dwFlags [ In]

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

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
Der hSslProvider-Parameter enthält einen ungültigen Zeiger.
NTE _ INVALID _ PARAMETER
0x80090027L
Der pCipherLengths-Parameter ist auf NULL festgelegt, oder die von cbCipherLengths angegebene Pufferlänge ist zu kurz.
NTE _ BAD _ FLAGS
0x80090009L
Der dwFlags-Parameter muss auf 0 (null) festgelegt werden.

Hinweise

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

Anforderungen

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