SslGetCipherSuitePRFHashAlgorithm-Funktion

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:

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