Bagikan melalui


Fungsi SslGenerateSessionKeys

Fungsi SslGenerateSessionKeys menghasilkan satu set kunci sesi Secure Sockets Layer protocol (SSL).

Sintaks

SECURITY_STATUS WINAPI SslGenerateSessionKeys(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hMasterKey,
  _Out_ NCRYPT_KEY_HANDLE  *phReadKey,
  _Out_ NCRYPT_KEY_HANDLE  *phWriteKey,
  _In_  PNCryptBufferDesc  pParameterList,
  _In_  DWORD              dwFlags
);

Parameter

hSslProvider [in]

Handel ke instans penyedia protokol SSL.

hMasterKey [in]

Handel ke objek kunci master .

phReadKey [out]

Penunjuk ke handel kunci baca yang dikembalikan.

phWriteKey [out]

Penunjuk ke handel kunci tulis yang dikembalikan.

pParameterList [in]

Penunjuk ke array buffer NCryptBuffer yang berisi informasi yang digunakan sebagai bagian dari operasi pertukaran kunci. Set buffer yang tepat tergantung pada protokol dan cipher suite yang digunakan. Minimal, daftar akan berisi buffer yang berisi nilai acak yang disediakan klien dan server.

dwFlags [in]

Parameter ini dicadangkan untuk digunakan di masa mendatang.

Mengembalikan 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_NO_MEMORY
0x8009000EL
Memori tidak cukup tersedia untuk mengalokasikan buffer yang diperlukan.
NTE_INVALID_HANDLE
0x80090026L
Salah satu handel yang disediakan tidak valid.
NTE_INVALID_PARAMETER
0x80090027L
Parameter phReadKey atau phWriteKey null.

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