Fungsi IoOpenDriverRegistryKey (wdm.h)

  • Artikel

Rutinitas IoOpenDriverRegistryKey mengembalikan handel ke kunci registri khusus driver untuk driver tertentu.

Sintaks

NTSTATUS IoOpenDriverRegistryKey(
  [in]  PDRIVER_OBJECT     DriverObject,
  [in]  DRIVER_REGKEY_TYPE RegKeyType,
  [in]  ACCESS_MASK        DesiredAccess,
  [in]  ULONG              Flags,
  [out] PHANDLE            DriverRegKey
);

Parameter

[in] DriverObject

Penunjuk ke struktur DRIVER_OBJECT . Struktur ini harus menjadi objek pengandar untuk pengandar panggilan.

[in] RegKeyType

Enumerasi jenis DRIVER_REGKEY_TYPE yang menunjukkan jenis kunci registri yang diminta.

[in] DesiredAccess

Menentukan nilai ACCESS_MASK yang mewakili hak akses yang diperlukan untuk kunci. Lihat ZwCreateKey untuk deskripsi setiap hak akses KEY_XXX.

[in] Flags

Atur ke nol.

[out] DriverRegKey

Penunjuk ke variabel HANDLE yang, saat berhasil dikembalikan, berisi handel ke kunci registri yang diminta.

Nilai kembali

IoOpenDriverRegistryKey mengembalikan STATUS_SUCCESS jika panggilan berhasil membuka handel ke kunci registri yang diminta.

Keterangan

Driver harus memanggil ZwClose untuk menutup handel yang dikembalikan dari rutinitas ini ketika akses tidak lagi diperlukan.

Kunci registri yang dibuka oleh rutinitas ini tidak bersifat nonvolatile.

Untuk menyediakan kunci dan nilai di bawah kunci registri DriverRegKeyParameters yang tidak dapat diubah, gunakan direktif AddReg dari bagian penginstalan layanan untuk mereferensikan bagian add-registry-section yang berisi entri dengan reg-root HKR dan subkunci .Parameters

Pemanggil IoOpenDriverRegistryKey harus berjalan di IRQL = PASSIVE_LEVEL dalam konteks utas sistem.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10 versi 1803
Header wdm.h (termasuk wdm.h, ntddk.h, atau ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Lihat juga

ZwClose

ACCESS_MASK

DRIVER_REGKEY_TYPE