Bagikan melalui


Fungsi SslGetCipherSuitePRFHashAlgorithm

Fungsi SslGetCipherSuitePRFHashAlgorithm mengembalikan Cryptography API: Next Generation (CNG) Pengidentifikasi Algoritma hash yang digunakan untuk protokol Keamanan Lapisan Transportasi (TLS) fungsi pseudo-random (PRF) untuk protokol input, rangkaian sandi, dan jenis kunci.

Sintaks

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]

Handel instans penyedia protokol Secure Sockets Layer protocol (SSL).

dwProtocol [in]

Salah satu nilai Pengidentifikasi Protokol Penyedia SSL CNG .

dwCipherSuite [in]

Salah satu nilai Pengidentifikasi Cipher Suite Penyedia SSL CNG .

dwKeyType [in]

Salah satu nilai Pengidentifikasi Jenis Kunci Penyedia SSL CNG . Untuk jenis kunci yang bukan kriptografi kurva elips (ECC), atur parameter ini ke nol.

szPRFHash [out]

Salah satu Pengidentifikasi Algoritma CNG untuk hash yang akan digunakan untuk TLS PRF.

dwFlags [in]

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke nol.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan nol.

Jika fungsi gagal, fungsi mengembalikan nilai kesalahan bukan nol.

Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.

Mengembalikan kode/nilai Deskripsi
NTE_INVALID_HANDLE
0x80090026L
Parameter hSslProvider berisi pointer yang tidak valid.
NTE_INVALID_PARAMETER
0x80090027L
Parameter szPRFHash diatur ke NULL.
NTE_NOT_SUPPORTED
0x80090029L
Fungsi yang dipilih tidak didukung dalam versi antarmuka yang ditentukan.
NTE_BAD_FLAGS
0x80090009L
Parameter dwFlags harus diatur ke nol.

Keterangan

Fungsi SslGetCipherSuitePRFHashAlgorithm ini dipanggil untuk percakapan TLS 1.2 atau yang lebih baru untuk mengkueri algoritma hashing yang akan digunakan dalam TLS PRF.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung
Windows Server 2008 R2 [hanya aplikasi desktop]
Header
Sslprovider.h
DLL
Ncrypt.dll