Fungsi SslImportKey

Fungsi SslImportKey mengimpor kunci ke penyedia protokol Secure Sockets Layer protocol (SSL).

Sintaks

SECURITY_STATUS WINAPI SslImportKey(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_KEY_HANDLE  *phKey,
  _In_  LPCWSTR            pszBlobType,
  _In_  PBYTE              pbKeyBlob,
  _In_  DWORD              cbKeyBlob,
  _In_  DWORD              dwFlags
);

Parameter

hSslProvider [in]

Handel ke instans penyedia protokol SSL.

phKey [out]

Penunjuk ke handel kunci kriptografi untuk menerima kunci yang diimpor.

pszBlobType [in]

String Unicode yang dihentikan null yang berisi pengidentifikasi yang menentukan jenis BLOB yang terkandung dalam buffer pbInput . Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
BCRYPT_DH_PUBLIC_BLOB	Ekspor kunci umum Diffie-Hellman. Buffer pbOutput menerima struktur BCRYPT_DH_KEY_BLOB segera diikuti oleh data utama.
BCRYPT_ECCPUBLIC_BLOB	Ekspor kunci publikkurva elips kriptografi (ECC). Buffer pbOutput menerima struktur BCRYPT_ECCKEY_BLOB segera diikuti oleh data utama.
BCRYPT_OPAQUE_KEY_BLOB	Ekspor kunci konten dalam format yang khusus untuk satu penyedia layanan kriptografi (CSP). BLOB buram tidak dapat ditransfer dan harus diimpor dengan menggunakan CSP yang sama yang menghasilkan BLOB.
BCRYPT_RSAPUBLIC_BLOB	Mengekspor kunci publik RSA . Buffer pbOutput menerima struktur BCRYPT_RSAKEY_BLOB segera diikuti oleh data utama.

pbKeyBlob [in]

Penunjuk ke buffer yang berisi BLOB kunci.

cbKeyBlob [in]

Ukuran, dalam byte, dari buffer pbKeyBlob .

dwFlags [in]

Parameter ini dicadangkan untuk digunakan di masa mendatang.

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.

Keterangan

Anda dapat menggunakan fungsi SslImportKey untuk mengimpor kunci sesi sebagai bagian dari proses mentransfer kunci sesi dari satu proses ke proses lainnya.

Persyaratan