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]

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, 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
NTE _ UNGÜLTIGES _ HANDLE
0x80090026L
Der hSslProvider-Parameter enthält einen ungültigen Zeiger.
NTE _ UNGÜLTIGER _ PARAMETER
0x80090027L
Der szPRFHash-Parameter ist auf NULL festgelegt.
NTE _ NICHT _ UNTERSTÜTZT
0x80090029L
Die ausgewählte Funktion wird in der angegebenen Version der -Schnittstelle nicht unterstützt.
NTE _ BAD _ FLAGS
0x80090009L
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
Sslprovider.h
DLL
Ncrypt.dll