Fungsi NCryptNotifyChangeKey (ncrypt.h)

Artikel
03/05/2024

Fungsi NCryptNotifyChangeKey membuat atau menghapus pemberitahuan perubahan kunci.

Handel yang disediakan oleh fungsi ini adalah handel yang sama yang dikembalikan oleh fungsi FindFirstChangeNotification . Anda menggunakan fungsi tunggu untuk menunggu handel pemberitahuan diberi sinyal.

Sintaks

SECURITY_STATUS NCryptNotifyChangeKey(
  [in]      NCRYPT_PROV_HANDLE hProvider,
  [in, out] HANDLE             *phEvent,
  [in]      DWORD              dwFlags
);

Parameter

[in] hProvider

Handel penyedia penyimpanan utama. Handel ini diperoleh dengan menggunakan fungsi NCryptOpenStorageProvider .

[in, out] phEvent

Alamat variabel HANDLE yang menerima atau berisi handel peristiwa pemberitahuan perubahan kunci. Ini adalah handel yang sama yang dikembalikan oleh fungsi FindFirstChangeNotification . Untuk informasi selengkapnya, lihat deskripsi parameter dwFlags .

[in] dwFlags

Sekumpulan bendera yang mengubah perilaku fungsi ini. Parameter ini berisi kombinasi satu atau beberapa nilai berikut.

Nilai	Makna
NCRYPT_REGISTER_NOTIFY_FLAG 0x00000001	Buat pemberitahuan perubahan baru. Parameter phEvent akan menerima handel pemberitahuan perubahan kunci.
NCRYPT_UNREGISTER_NOTIFY_FLAG 0x00000002	Menghapus pemberitahuan perubahan yang ada. Parameter phEvent harus berisi handel pemberitahuan perubahan kunci yang valid. Handel ini tidak lagi valid setelah fungsi ini dipanggil dengan bendera ini dan nilai INVALID_HANDLE_VALUE ditempatkan dalam handel ini.
NCRYPT_MACHINE_KEY_FLAG 0x00000020	Menerima pemberitahuan perubahan untuk kunci di penyimpanan kunci komputer. Jika bendera ini tidak ditentukan, peristiwa pemberitahuan perubahan hanya akan terjadi untuk kunci di penyimpanan kunci pengguna panggilan. Bendera ini hanya valid jika dikombinasikan dengan bendera NCRYPT_REGISTER_NOTIFY_FLAG .

Nilai kembali

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 hProvider tidak valid.
NTE_INVALID_PARAMETER	Satu atau beberapa parameter 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 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	ncrypt.h
Pustaka	Ncrypt.lib
DLL	Ncrypt.dll

Lihat juga

FindFirstChangeNotification

Bagikan melalui