struktur REG_SET_VALUE_KEY_INFORMATION (wdm.h)

Artikel
07/02/2025

Struktur REG_SET_VALUE_KEY_INFORMATION menjelaskan pengaturan baru untuk entri nilai kunci registri.

Sintaksis

C++

typedef struct _REG_SET_VALUE_KEY_INFORMATION {
  PVOID           Object;
  PUNICODE_STRING ValueName;
  ULONG           TitleIndex;
  ULONG           Type;
  PVOID           Data;
  ULONG           DataSize;
  PVOID           CallContext;
  PVOID           ObjectContext;
  PVOID           Reserved;
} REG_SET_VALUE_KEY_INFORMATION, *PREG_SET_VALUE_KEY_INFORMATION;

Anggota

Object

Penunjuk ke objek kunci registri untuk kunci yang entri nilainya akan diubah.

ValueName

Penunjuk ke struktur UNICODE_STRING yang berisi nama entri nilai yang akan diubah.

TitleIndex

Dicadangkan untuk penggunaan sistem. Driver harus mengabaikan anggota ini.

Type

Jenis data yang akan ditulis. Untuk informasi selengkapnya tentang kemungkinan nilai untuk anggota ini, lihat parameter JenisZwSetValueKey.

Data

Penunjuk ke buffer yang berisi data yang akan ditulis. Format buffer tergantung pada nilai jenis . Untuk informasi selengkapnya, lihat ZwSetValueKey.

DataSize

Ukuran, dalam byte, dari buffer Data.

CallContext

Informasi konteks opsional yang ditentukan driver yang dapat disediakan oleh rutinitas RegistryCallback driver. Anggota ini didefinisikan untuk Windows Vista dan versi yang lebih baru dari sistem operasi Windows.

ObjectContext

Penunjuk ke informasi konteks yang ditentukan driver yang telah dikaitkan dengan objek registri dengan memanggil CmSetCallbackObjectContext. Anggota ini didefinisikan untuk Windows Vista dan versi yang lebih baru dari sistem operasi Windows.

Reserved

Anggota ini dicadangkan untuk digunakan di masa mendatang. Anggota ini didefinisikan untuk Windows Vista dan versi yang lebih baru dari sistem operasi Windows.

Komentar

Sistem meneruskan struktur ini ke rutinitas RegistryCallback setiap kali utas mencoba mengatur entri nilai untuk kunci—misalnya, saat utas mode pengguna memanggil RegSetValue atau RegSetValueEx atau saat driver memanggil ZwSetValueKey.

Untuk informasi selengkapnya tentang operasi pemfilteran registri, lihat Memfilter Panggilan Registri.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Tersedia di Microsoft Windows XP dan versi sistem operasi Windows yang lebih baru.
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)

Lihat juga

CmSetCallbackObjectContext

RegistryCallback

ZwSetValueKey

Bagikan melalui