Bagikan melalui


Fungsi SslCreateClientAuthHash

Fungsi SslCreateClientAuthHash mengambil handel ke hash jabat tangan yang digunakan untuk autentikasi klien.

Sintaks

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

Parameter

hSslProvider [in]

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

phHandshakeHash [out]

Penunjuk ke variabel NCRYPT_HASH_HANDLE untuk menerima handel hash.

dwProtocol [in]

Salah satu nilai Pengidentifikasi Protokol Penyedia SSL CNG .

dwCipherSuite [in]

Salah satu nilai Pengidentifikasi Cipher Suite Penyedia SSL CNG .

pszHashAlgId [in]

Salah satu nilai Pengidentifikasi Algoritma CNG .

dwFlags [in]

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

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.

Mengembalikan kode/nilai Deskripsi
NTE_INVALID_HANDLE
0x80090026L
Parameter hSslProvider berisi pointer yang tidak valid.
NTE_INVALID_PARAMETER
0x80090027L
Parameter phHandshakeHash diatur ke NULL.
NTE_NOT_SUPPORTED
0x80090029L
Fungsi yang dipilih tidak didukung dalam versi antarmuka yang ditentukan.
NTE_NO_MEMORY
0x8009000EL
Tidak cukup memori untuk mengalokasikan buffer.
NTE_BAD_FLAGS
0x80090009L
Parameter dwFlags harus diatur ke nol.

Keterangan

Fungsi SslCreateClientAuthHash dipanggil untuk protokol Keamanan Lapisan Transportasi (TLS) 1.2 atau percakapan yang lebih baru untuk membuat objek hash yang digunakan untuk hash pesan jabat tangan. Ini dipanggil sekali untuk setiap algoritma hash yang mungkin dapat digunakan dalam tanda tangan autentikasi klien.

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