Fungsi NCryptDeleteKey (ncrypt.h)

Artikel
05/20/2023

Fungsi NCryptDeleteKey menghapus kunci CNG.

Sintaks

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

Parameter

[in] hKey

Handel kunci yang akan dihapus. Handel ini diperoleh dengan menggunakan fungsi NCryptOpenKey .

Catatan Fungsi NCryptDeleteKey menghapus kunci dan membebaskan handel. Aplikasi dapat menggunakan fungsi NCryptFreeObject untuk membebaskan handel jika NCryptDeleteKey gagal.

[in] dwFlags

Bendera yang mengubah perilaku fungsi. Ini bisa nol atau kombinasi nilai yang khusus untuk setiap penyedia penyimpanan utama.

Nilai	Makna
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


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

Lihat juga

NCryptOpenKey

Bagikan melalui