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 |
---|---|
|
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 |
|
DLL |
|