Fungsi NtQueryInformationByName (ntifs.h)
NtQueryInformationByName mengembalikan informasi yang diminta tentang file yang ditentukan oleh nama file.
Sintaks
__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationByName(
[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. |
| FileStatBasicInformation (77) | FILE_STAT_BASIC_INFORMATION. Tersedia dimulai dengan Windows 11, build 26048. |
Nilai kembali
NtQueryInformationByName 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 NtQueryInformationByName dan mengembalikan informasi yang diminta tentang file. Ini melakukannya tanpa membuka file aktual, membuatnya lebih efisien daripada NtQueryInformationFile, yang memerlukan file terbuka (dan penutupan file berikutnya).
Pemanggil NtQueryInformationByName harus berjalan di IRQL = PASSIVE_LEVEL dan dengan APC kernel khusus diaktifkan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 10, versi 1703 |
| Header | ntifs.h |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL (lihat bagian Keterangan) |