Fungsi ZwQueryObject (ntifs.h)

  • Artikel

Rutinitas ZwQueryObject menyediakan informasi tentang objek yang disediakan.

Sintaks

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 penelepon yang menerima informasi yang diminta.

[in] ObjectInformationLength

Menentukan ukuran, dalam byte, dari buffer ObjectInformation .

[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.

Nilai kembali

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

Menampilkan 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.

Keterangan

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

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000.
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h, FltKernel.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(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