Fungsi SslExportKeyingMaterial

Mengekspor bahan kunci sesuai standar RFC 5705. Fungsi ini menggunakan fungsi pseudorandom TLS untuk menghasilkan buffer byte bahan kunci. Dibutuhkan referensi ke rahasia master, label ASCII yang membedakan, nilai acak klien dan server, dan secara opsional data konteks aplikasi.

Sintaks

SECURITY_STATUS WINAPI SslExportKeyingMaterial(
  _In_     NCRYPT_PROV_HANDLE hSslProvider,
  _In_     NCRYPT_KEY_HANDLE  hMasterKey,
  _In_     PCHAR              sLabel,
  _In_     PBYTE              pbRandoms,
  _In_     DWORD              cbRandoms,
  _In_opt_ PBYTE              pbContextValue,
  _In_     WORD               cbContextValue,
  _Out_    PBYTE              pbOutput,
  _In_     DWORD              cbOutput,
  _In_     DWORD              dwFlags
);

Parameter

hSslProvider [in]

Handel instans penyedia protokol TLS.

hMasterKey [in]

Handel objek kunci master yang akan digunakan untuk membuat materi kunci untuk br diekspor.

sLabel [in]

string label ASCII yang dihentikan NUL. Schannel akan menghapus karakter NUL yang mengakhiri sebelum meneruskannya ke fungsi pseudorandom.

pbRandoms [in]

Penunjuk ke buffer yang berisi penggabungan nilai client_random dan server_random koneksi TLS.

cbRandoms [in]

Panjangnya, dalam byte, dari penyangga pbRandoms .

pbContextValue [in, opsional]

Penunjuk ke buffer yang berisi konteks aplikasi. Jika pbContextValue adalah NULL, cbContextValue harus nol.

cbContextValue [in]

Panjangnya, dalam byte, dari buffer pbContextValue .

pbOutput [out]

Alamat buffer yang menerima bahan kunci yang diekspor. Parameter cbOutput berisi ukuran buffer ini. Nilai ini tidak boleh NULL.

cbOutput [in]

Panjangnya, dalam byte, dari buffer pbOutput . Harus lebih besar dari nol.

dwFlags [in]

Tidak digunakan. Harus diatur ke nol.

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.

Persyaratan