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 |
---|---|
|
Parameter hSslProvider berisi pointer yang tidak valid. |
|
Parameter szPRFHash diatur ke NULL. |
|
Fungsi yang dipilih tidak didukung dalam versi antarmuka yang ditentukan. |
|
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 |
|
DLL |
|