Bagikan melalui


Fungsi SslCreateHandshakeHash

Fungsi SslCreateHandshakeHash mendapatkan handel hash yang digunakan untuk hash pesan jabat tangan.

Sintaks

SECURITY_STATUS WINAPI SslCreateHandshakeHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwFlags
);

Parameter

hSslProvider [in]

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

phHandshakeHash [out]

Handel hash yang dapat diteruskan ke fungsi penyedia SSL lainnya.

dwProtocol [in]

Salah satu nilai Pengidentifikasi Protokol Penyedia SSL CNG .

Catatan

Fungsi ini tidak digunakan dengan protokol SSL 2.0.

dwCipherSuite [in]

Salah satu nilai Pengidentifikasi Cipher Suite Penyedia SSL CNG .

dwFlags [in]

Parameter ini dicadangkan untuk digunakan di masa mendatang.

Nilai kembali

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_NO_MEMORY
0x8009000EL
Memori tidak cukup untuk mengalokasikan buffer hash.
NTE_INVALID_HANDLE
0x80090026L
Handel hSslProvider tidak valid.
NTE_INVALID_PARAMETER
0x80090027L
PhHandshakeHash null.

Keterangan

Fungsi SslCreateHandshakeHash 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 disebut berapa kali dengan handel hash untuk menambahkan data ke hash.
  3. Fungsi SslComputeFinishedHash dipanggil dengan handel hash untuk mendapatkan hash data.

Persyaratan

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