SslGetCipherSuitePRFHashAlgorithm-Funktion

Artikel
06/12/2023

Die SslGetCipherSuitePRFHashAlgorithm-Funktion gibt die Kryptografie-API: Algorithmusbezeichner der nächsten Generation (CNG) des Hashingalgorithmus zurück, der für die Pseudo-Random-Funktion (TRANSPORT Layer Security Protocol, 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 des SSL-Protokollanbieters (Secure Sockets Layer Protocol) instance.
dwProtocol [in]: Einer der Werte des CNG-SSL-Anbieterprotokollbezeichners .
dwCipherSuite [in]: Einer der CNG SSL Provider Cipher Suite Identifier-Werte .
dwKeyType [in]: Einer der Werte für den CNG-SSL-Anbieterschlüsseltypbezeichner . Legen Sie für Schlüsseltypen, die keine Elliptic Curve Cryptography (ECC) sind, diesen Parameter auf 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 null zurück.

Wenn die Funktion fehlschlägt, wird ein Fehlerwert ungleich null zurückgegeben.

Mögliche Rückgabecodes sind u. a. die folgenden:

Rückgabecode/-wert	Beschreibung
NTE_INVALID_HANDLE 0x80090026L	Der Parameter hSslProvider enthält einen ungültigen Zeiger.
NTE_INVALID_PARAMETER 0x80090027L	Der szPRFHash-Parameter ist auf NULL festgelegt.
NTE_NOT_SUPPORTED 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.

Bemerkungen

Diese SslGetCipherSuitePRFHashAlgorithm-Funktion wird für TLS 1.2- oder höher-Unterhaltungen aufgerufen, um den Hashalgorithmus abzufragen, der in der TLS-PRF verwendet wird.

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