Fungsi SslComputeFinishedHash

Fungsi SslComputeFinishedHash menghitung hash yang dikirim dalam pesan selesai dari jabat tangan protokol Secure Sockets Layer (SSL).

Sintaks

SECURITY_STATUS WINAPI SslComputeFinishedHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hMasterKey,
  _In_  NCRYPT_HASH_HANDLE hHandshakeHash,
  _Out_ PBYTE              pbOutput,
  _In_  DWORD              cbOutput,
  _In_  DWORD              dwFlags
);

Parameter

hSslProvider [in]

Handel instans penyedia protokol SSL.

hMasterKey [in]

Handel objek kunci master .

hHandshakeHash [in]

Handel hash pesan jabat tangan.

pbOutput [out]

Penunjuk ke buffer yang menerima hash untuk pesan selesai.

cbOutput [in]

Panjangnya, dalam byte, dari buffer pbOutput .

dwFlags [in]

Salah satu konstanta berikut.

Nilai	Makna
NCRYPT_SSL_CLIENT_FLAG 0x00000001	Menentukan bahwa ini adalah panggilan klien.
NCRYPT_SSL_SERVER_FLAG 0x00000002	Menentukan bahwa ini adalah panggilan server.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan nol.

Jika fungsi gagal, fungsi mengembalikan nilai kesalahan bukan nol.

Keterangan

Fungsi SslComputeFinishedHash adalah salah satu dari tiga fungsi yang digunakan untuk menghasilkan hash untuk digunakan selama jabat tangan SSL.

1. Fungsi SslCreateHandshakeHash dipanggil untuk mendapatkan handel hash.
2. Fungsi SslHashHandshake dipanggil beberapa kali dengan handel hash untuk menambahkan data ke hash.
3. Fungsi SslComputeFinishedHash dipanggil dengan handel hash untuk mendapatkan hash data.

Nilai hash dihitung dengan hash rahasia master dengan hash dari semua pesan jabat tangan sebelumnya yang dikirim atau diterima.

Nilai cbOutput menentukan panjang data hash. Ketika protokol Transport Layer Security (TLS) 1.0 digunakan, ini harus selalu 12 (byte). Untuk informasi selengkapnya, lihat Protokol TLS Versi 1.0.

Persyaratan