Fungsi NCryptFinalizeKey (ncrypt.h)

Artikel
03/05/2024

Fungsi NCryptFinalizeKey menyelesaikan kunci penyimpanan kunci CNG. Kunci tidak dapat digunakan sampai fungsi ini dipanggil.

Sintaks

SECURITY_STATUS NCryptFinalizeKey(
  [in] NCRYPT_KEY_HANDLE hKey,
  [in] DWORD             dwFlags
);

Parameter

[in] hKey

Handel kunci yang akan diselesaikan. Handel ini diperoleh dengan memanggil fungsi NCryptCreatePersistedKey .

[in] dwFlags

Bendera yang mengubah perilaku fungsi. Ini bisa menjadi nol atau kombinasi dari satu atau beberapa nilai berikut.

Nilai	Makna
NCRYPT_NO_KEY_VALIDATION	Jangan validasi bagian publik dari pasangan kunci. Bendera ini hanya berlaku untuk pasangan kunci publik/privat.
NCRYPT_WRITE_KEY_TO_LEGACY_STORE_FLAG	Simpan juga kunci dalam penyimpanan warisan. Ini memungkinkan kunci untuk digunakan dengan CryptoAPI. Bendera ini hanya berlaku untuk kunci RSA.
NCRYPT_SILENT_FLAG	Meminta agar penyedia layanan utama (KSP) tidak menampilkan antarmuka pengguna apa pun. Jika penyedia harus menampilkan UI untuk beroperasi, panggilan gagal dan KSP harus mengatur kode kesalahan NTE_SILENT_CONTEXT sebagai kesalahan terakhir.

Mengembalikan nilai

Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.

Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode	Deskripsi
ERROR_SUCCESS	Fungsi berhasil.
NTE_BAD_FLAGS	Parameter dwFlags berisi nilai yang tidak valid.
NTE_INVALID_HANDLE	Parameter hKey tidak valid.

Keterangan

Layanan tidak boleh memanggil fungsi ini dari Fungsi StartService-nya. Jika layanan memanggil fungsi ini dari fungsi StartService-nya, kebuntuan dapat terjadi, dan layanan mungkin berhenti merespons.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	ncrypt.h
Pustaka	Ncrypt.lib
DLL	Ncrypt.dll

Bagikan melalui