Bagikan melalui


Fungsi SslLookupCipherLengths

Fungsi SslLookupCipherLengths mengembalikan struktur NCRYPT_SSL_CIPHER_LENGTHS yang berisi panjang header dan trailer protokol input, cipher suite, dan jenis kunci.

Sintaks

SECURITY_STATUS WINAPI SslLookupCipherLengths(
  _In_  NCRYPT_PROV_HANDLE        hSslProvider,
  _In_  DWORD                     dwProtocol,
  _In_  DWORD                     dwCipherSuite,
  _In_  DWORD                     dwKeyType,
  _Out_ NCRYPT_SSL_CIPHER_LENGTHS *pCipherLengths,
  _In_  DWORD                     cbCipherLengths,
  _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.

pCipherLengths [out]

Penunjuk ke buffer untuk menerima struktur NCRYPT_SSL_CIPHER_LENGTHS .

cbCipherLengths [in]

Panjang, dalam byte, dari buffer yang diacu oleh parameter pCipherLengths .

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 pCipherLengths diatur ke NULL atau panjang buffer yang ditentukan oleh cbCipherLengths terlalu pendek.
NTE_BAD_FLAGS
0x80090009L
Parameter dwFlags harus diatur ke nol.

Keterangan

Fungsi SslLookupCipherLengths dipanggil untuk protokol Keamanan Lapisan Transportasi (TLS) 1.1 atau percakapan yang lebih baru untuk mengkueri panjang header dan trailer untuk protokol yang diminta, cipher suite, dan jenis kunci.

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