Fungsi SslComputeClientAuthHash

Fungsi SslComputeClientAuthHash menghitung hash untuk digunakan selama autentikasi sertifikat .

Sintaks

SECURITY_STATUS WINAPI SslComputeClientAuthHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hMasterKey,
  _In_  NCRYPT_HASH_HANDLE hHandshakeHash,
  _In_  LPCWSTR            pszAlgId,
  _Out_ PBYTE              pbOutput,
  _In_  DWORD              cbOutput,
  _Out_ DWORD              *pcbResult,
  _In_  DWORD              dwFlags
);

Parameter

hSslProvider [in]

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

hMasterKey [in]

Handel objek kunci master .

hHandshakeHash [in]

Handel hash jabat tangan yang dihitung sejauh ini.

pszAlgId [in]

Penunjuk ke string Unicode yang dihentikan null yang mengidentifikasi algoritma kriptografi yang diminta. Ini bisa menjadi salah satu Pengidentifikasi Algoritma CNG standar atau pengidentifikasi untuk algoritma terdaftar lainnya.

pbOutput [out]

Alamat buffer yang menerima BLOB kunci. Parameter cbOutput berisi ukuran buffer ini. Jika parameter ini NULL, fungsi ini akan menempatkan ukuran yang diperlukan, dalam byte, dalam DWORD yang ditunjukkan oleh parameter pcbResult .

cbOutput [in]

Panjangnya, dalam byte, dari buffer pbOutput .

pcbResult [out]

Penunjuk ke nilai DWORD yang menentukan panjang, dalam byte, dari hash yang ditulis ke buffer pbOutput .

dwFlags [in]

Parameter ini dicadangkan untuk digunakan di masa mendatang.

Menampilkan 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.

Keterangan

Fungsi SslComputeClientAuthHash menghitung hash yang dikirim dalam pesan verifikasi sertifikat jabat tangan SSL. Nilai hash dihitung dengan membuat hash yang berisi rahasia utama dengan hash dari semua pesan jabat tangan sebelumnya yang dikirim atau diterima.

Cara hash dihitung tergantung pada protokol dan cipher suite yang digunakan. Selain itu, hash tergantung pada jenis kunci autentikasi klien yang digunakan; parameter pszAlgId menunjukkan jenis kunci yang digunakan untuk autentikasi klien.

Persyaratan