Fungsi ZwQueryInformationByName (wdm.h)

Artikel
02/29/2024

ZwQueryInformationByName mengembalikan informasi yang diminta tentang file yang ditentukan oleh nama file.

Sintaks

NTSYSAPI NTSTATUS ZwQueryInformationByName(
  [in]  POBJECT_ATTRIBUTES     ObjectAttributes,
  [out] PIO_STATUS_BLOCK       IoStatusBlock,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

Parameter

[in] ObjectAttributes

Arahkan ke struktur OBJECT_ATTRIBUTES yang berisi atribut file, termasuk nama file.

[out] IoStatusBlock

Arahkan struktur IO_STATUS_BLOCK yang berisi status I/O penelepon.

[out] FileInformation

Arahkan ke buffer yang disediakan penelepon untuk mengembalikan informasi yang diminta tentang file. Struktur buffer ditentukan oleh parameter FileInformationClass .

[in] Length

Panjang, dalam byte, dari buffer yang ditinjuk FileInformation .

[in] FileInformationClass

Nilai FILE_INFORMATION_CLASS yang mengidentifikasi jenis informasi file yang akan dikembalikan dalam buffer yang dirujuk FileInformation . FileInformationClass bisa menjadi salah satu nilai berikut.

Nilai FILE_INFORMATION_CLASS	Tipe Informasi yang Akan Dikembalikan
FileStatInformation (68)	FILE_STAT_INFORMATION. Tersedia dimulai dengan Windows 10, versi 1709.
FileStatLxInformation (70)	FILE_STAT_LX_INFORMATION. Tersedia mulai Windows 10 Pembaruan April 2018.
FileCaseSensitiveInformation (71)	FILE_CASE_SENSITIVE_INFORMATION. Tersedia mulai Windows 10 Pembaruan April 2018.

Mengembalikan nilai

ZwQueryInformationByName mengembalikan STATUS_SUCCESS setelah berhasil diselesaikan; jika tidak, kode kesalahan akan dikembalikan, seperti salah satu dari berikut ini.

Kode Kesalahan	Makna
STATUS_INVALID_PARAMETER	Parameter FileInformationClass berisi nilai yang tidak valid.
STATUS_INFO_LENGTH_MISMATCH	Ukuran buffer yang ditentukan oleh Panjang tidak cukup besar untuk memuat informasi yang diminta.

Keterangan

Kueri ZwQueryInformationByName dan mengembalikan informasi yang diminta tentang file. Ini melakukannya tanpa membuka file aktual, membuatnya lebih efisien daripada ZwQueryInformationFile, yang memerlukan file terbuka (dan penutupan file berikutnya).

Penelepon ZwQueryInformationByName harus berjalan di IRQL = PASSIVE_LEVEL dan dengan APC kernel khusus diaktifkan.