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]
-
dwCipherSuite [ In]
-
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 |
|---|---|
|
Der hSslProvider-Parameter enthält einen ungültigen Zeiger. |
|
Der pCipherLengths-Parameter ist auf NULL festgelegt, oder die von cbCipherLengths angegebene Pufferlänge ist zu kurz. |
|
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 |
|
| DLL |
|