Fungsi NtNotifyChangeMultipleKeys (winternl.h)

Artikel
08/27/2023

[Fungsi ini dapat diubah atau dihapus dari Windows tanpa pemberitahuan lebih lanjut. ]

Meminta pemberitahuan saat kunci registri atau subkuntangnya berubah.

Sintaks

__kernel_entry NTSTATUS NtNotifyChangeMultipleKeys(
  [in]            HANDLE               MasterKeyHandle,
  [in, optional]  ULONG                Count,
  [in, optional]  OBJECT_ATTRIBUTES [] SubordinateObjects,
  [in, optional]  HANDLE               Event,
  [in, optional]  PIO_APC_ROUTINE      ApcRoutine,
  [in, optional]  PVOID                ApcContext,
  [out]           PIO_STATUS_BLOCK     IoStatusBlock,
  [in]            ULONG                CompletionFilter,
  [in]            BOOLEAN              WatchTree,
  [out, optional] PVOID                Buffer,
  [in]            ULONG                BufferSize,
  [in]            BOOLEAN              Asynchronous
);

Parameter

[in] MasterKeyHandle

Handel ke kunci terbuka. Handel harus dibuka dengan hak akses KEY_NOTIFY .

[in, optional] Count

Jumlah subkey di bawah kunci yang ditentukan oleh parameter MasterKeyHandle . Parameter ini harus 1.

[in, optional] SubordinateObjects

Arahkan ke array struktur OBJECT_ATTRIBUTES , satu untuk setiap subkunci. Array ini dapat berisi satu struktur OBJECT_ATTRIBUTES .

[in, optional] Event

Handel ke peristiwa yang dibuat oleh pemanggil. Jika Peristiwa bukan NULL, penelepon menunggu hingga operasi berhasil, pada saat peristiwa disinyalkan.

[in, optional] ApcRoutine

Penunjuk ke fungsi panggilan prosedur asinkron (APC) yang disediakan oleh pemanggil. Jika ApcRoutine bukan NULL, fungsi APC yang ditentukan dijalankan setelah operasi selesai.

[in, optional] ApcContext

Penunjuk ke konteks yang disediakan oleh pemanggil untuk fungsi APC-nya. Nilai ini diteruskan ke fungsi APC saat dijalankan. Parameter Asinkron harus TRUE. Jika ApcContext ditentukan, parameter Peristiwa harus NULL.

[out] IoStatusBlock

Penunjuk ke struktur IO_STATUS_BLOCK yang berisi status akhir dan informasi tentang operasi. Untuk panggilan yang berhasil yang mengembalikan data, jumlah byte yang ditulis ke parameter Buffer disediakan dalam anggota Informasi dari struktur IO_STATUS_BLOCK .

[in] CompletionFilter

Bitmap operasi yang memicu pemberitahuan. Parameter ini bisa menjadi satu atau beberapa bendera berikut.

Nilai	Makna
REG_NOTIFY_CHANGE_NAME	Beri tahu pemanggil jika subkunci ditambahkan atau dihapus.
REG_NOTIFY_CHANGE_ATTRIBUTES	Beri tahu pemanggil perubahan pada atribut kunci, seperti informasi deskriptor keamanan.
REG_NOTIFY_CHANGE_LAST_SET	Beri tahu pemanggil perubahan pada nilai kunci. Ini dapat mencakup penambahan atau penghapusan nilai, atau mengubah nilai yang ada.
REG_NOTIFY_CHANGE_SECURITY	Beri tahu pemanggil perubahan pada deskriptor keamanan kunci.

[in] WatchTree

Jika parameter ini TRUE, pemanggil diberi tahu tentang perubahan pada semua subkunci kunci yang ditentukan. Jika parameter ini FALSE, pemanggil hanya diberi tahu tentang perubahan pada kunci yang ditentukan.

[out, optional] Buffer

Dicadangkan untuk penggunaan sistem. Parameter ini harus NULL.

[in] BufferSize

Dicadangkan untuk penggunaan sistem. Parameter ini harus nol.

[in] Asynchronous

Jika parameter ini TRUE, fungsi akan segera kembali. Jika parameter ini FALSE, fungsi tidak mengembalikan hingga peristiwa yang ditentukan terjadi.

Nilai kembali

Mengembalikan NTSTATUS atau kode kesalahan.

Jika parameter AsinkronTRUE dan peristiwa yang ditentukan belum terjadi, fungsi mengembalikan STATUS_PENDING.

Formulir dan signifikansi kode kesalahan NTSTATUS tercantum dalam file header Ntstatus.h yang tersedia di WDK, dan dijelaskan dalam dokumentasi WDK.

Keterangan

Fungsi ini tidak memiliki file header terkait. Anda juga dapat menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Ntdll.dll.

Persyaratan


Target Platform	Windows
Header	winternl.h
Pustaka	ntdll.lib
DLL	ntdll.dll

Lihat juga

Keamanan Kunci Registri dan Hak Akses

Bagikan melalui