Fungsi ZwQueryObject (ntifs.h)

Artikel
12/22/2024

Rutinitas ZwQueryObject menyediakan informasi tentang objek yang disediakan.

Sintaksis

NTSYSAPI NTSTATUS ZwQueryObject(
  [in, optional]  HANDLE                   Handle,
  [in]            OBJECT_INFORMATION_CLASS ObjectInformationClass,
  [out, optional] PVOID                    ObjectInformation,
  [in]            ULONG                    ObjectInformationLength,
  [out, optional] PULONG                   ReturnLength
);

Parameter

[in, optional] Handle

Handel ke objek untuk mendapatkan informasi tentang.

[in] ObjectInformationClass

Menentukan nilai OBJECT_INFORMATION_CLASS yang menentukan jenis informasi yang dikembalikan dalam buffer ObjectInformation .

[out, optional] ObjectInformation

Penunjuk ke buffer yang dialokasikan pemanggil yang menerima informasi yang diminta.

[in] ObjectInformationLength

Menentukan ukuran, dalam byte, dari objectInformation buffer.

[out, optional] ReturnLength

Penunjuk ke variabel yang menerima ukuran, dalam byte, dari informasi kunci yang diminta. Jika ZwQueryObject mengembalikan STATUS_SUCCESS, variabel berisi jumlah data yang dikembalikan. Jika ZwQueryObject mengembalikan STATUS_BUFFER_OVERFLOW atau STATUS_BUFFER_TOO_SMALL, Anda dapat menggunakan nilai variabel untuk menentukan ukuran buffer yang diperlukan.

Mengembalikan nilai

ZwQueryObject mengembalikan STATUS_SUCCESS atau status kesalahan yang sesuai. Kemungkinan kode status kesalahan meliputi yang berikut ini:

Mengembalikan kode	Deskripsi
STATUS_ACCESS_DENIED	Tidak ada cukup izin untuk melakukan kueri ini.
STATUS_INVALID_HANDLE	Handel objek yang disediakan tidak valid.
STATUS_INFO_LENGTH_MISMATCH	Panjang info tidak cukup untuk menyimpan data.

Komentar

Jika panggilan ke fungsi ZwQueryObject terjadi dalam mode pengguna, Anda harus menggunakan nama "NtQueryObject" alih-alih "ZwQueryObject".

Untuk panggilan dari driver mode kernel, NtXxx dan ZwXxx versi rutin Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara NtXxx dan versi ZwXxx rutin, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000.
Platform Target	Universal
Header	ntifs.h (termasuk Ntifs.h, FltKernel.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
aturan kepatuhan DDI	HwStorPortProhibitedDIs (storport), PowerIrpDDis(wdm)

Lihat juga

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

Bagikan melalui