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 |
---|---|
|
Parameter hSslProvider berisi pointer yang tidak valid. |
|
Parameter pCipherLengths diatur ke NULL atau panjang buffer yang ditentukan oleh cbCipherLengths terlalu pendek. |
|
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 |
|
DLL |
|