SslGetCipherSuitePRFHashAlgorithm-Funktion
Die SslGetCipherSuitePRFHashAlgorithm-Funktion gibt den CNG-Algorithmusbezeichner (Cryptography API: Next Generation) des Hashalgorithmus zurück, der für die PSEUDO-Random-Funktion (PRF) des Transport Layer Security-Protokolls (TLS) für das Eingabeprotokoll, die Verschlüsselungssammlung und den Schlüsseltyp verwendet wird.
Syntax
SECURITY_STATUS WINAPI SslGetCipherSuitePRFHashAlgorithm(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_In_ DWORD dwProtocol,
_In_ DWORD dwCipherSuite,
_In_ DWORD dwKeyType,
_Out_ WCHAR szPRFHash[NCRYPT_SSL_MAX_NAME_SIZE],
_In_ DWORD dwFlags
);
Parameter
-
hSslProvider [ In]
-
Das Handle der SSL-Secure Sockets Layer (Protokollanbieterinstanz).
-
dwProtocol [ In]
-
dwCipherSuite [ In]
-
dwKeyType [ In]
-
Einer der CNG SSL Provider Key Type Identifier-Werte. Legen Sie für Schlüsseltypen, die keine ECC -Kryptografie (Elliptic Curve Cryptography) sind, diesen Parameter auf 0 (null) fest.
-
szPRFHash [ out]
-
Einer der CNG-Algorithmusbezeichner für den Hash, der für die TLS-PRF verwendet wird.
-
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 szPRFHash-Parameter ist auf NULL festgelegt. |
|
Die ausgewählte Funktion wird in der angegebenen Version der -Schnittstelle nicht unterstützt. |
|
Der dwFlags-Parameter muss auf 0 (null) festgelegt werden. |
Hinweise
Diese SslGetCipherSuitePRFHashAlgorithm-Funktion wird für TLS 1.2- oder höher-Konversationen aufgerufen, um den Hashalgorithmus abfragen zu können, der in der TLS-PRF verwendet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 7 [ Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server 2008 [ R2-Desktop-Apps] |
| Header |
|
| DLL |
|