Bagikan melalui


Fungsi SslExportKey

Fungsi SslExportKey mengembalikan kunci sesiSecure Sockets Layer protocol (SSL) atau kunci sementara publik ke dalam BLOB berseri.

Sintaks

SECURITY_STATUS WINAPI SslExportKey(
  _In_      NCRYPT_PROV_HANDLE hSslProvider,
  _In_      NCRYPT_KEY_HANDLE  hKey,
  _In_      LPCWSTR            pszBlobType,
  _Out_opt_ PBYTE              pbOutput,
  _In_      DWORD              cbOutput,
  _Out_     DWORD              *pcbResult,
  _In_      DWORD              dwFlags
);

Parameter

hSslProvider [in]

Handel instans penyedia protokol SSL.

hKey [in]

Handel kunci yang akan diekspor.

Ketika Anda tidak menentukan kunci, atur parameter ini ke NULL.

Catatan

Handel hKey diperoleh dengan memanggil fungsi SslOpenPrivateKey . Handel yang diperoleh dari fungsi NCryptOpenKey tidak didukung.

pszBlobType [in]

String Unicode yang dihentikan null yang berisi pengidentifikasi yang menentukan jenis BLOB yang akan diekspor. 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 umum kriptografi kurva elips (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 penyedia layanan kriptografi (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.

pbOutput [keluar, opsional]

Alamat buffer yang menerima BLOB kunci. Parameter cbOutput berisi ukuran buffer ini. Jika parameter ini NULL, fungsi ini akan menempatkan ukuran yang diperlukan, dalam byte, dalam DWORD yang ditunjukkan oleh parameter pcbResult .

cbOutput [in]

Ukuran, dalam byte, dari buffer pbOutput .

pcbResult [out]

Alamat variabel DWORD yang menerima jumlah byte yang disalin ke buffer pbOutput . Jika parameter pbOutput diatur ke NULL saat fungsi dipanggil, ukuran yang diperlukan untuk buffer pbOutput , dalam byte, dikembalikan dalam DWORD yang ditunjukkan oleh parameter ini.

dwFlags [in]

Disiapkan untuk penggunaan masa mendatang.

Nilai kembali

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
Salah satu handel yang disediakan tidak valid.

Keterangan

Fungsi SslExportKey memfasilitasi pengangkutan kunci sesi dari satu proses ke proses lainnya serta mengekspor bagian publik kunci sementara.

Saat mengekspor kunci sesi, jenis BLOB buram, yang berarti bahwa format BLOB tidak relevan selama fungsi SslExportKey dan SslImportKey dapat menafsirkannya.

Saat mengekspor bagian publik dari kunci sementara, jenis BLOB harus merupakan jenis yang sesuai, seperti NCRYPT_DH_PUBLIC_BLOB atau NCRYPT_ECCPUBLIC_BLOB.

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