Fungsi FsRtlQueryKernelEaFile (ntifs.h)

Artikel
02/29/2024

FsRtlQueryKernelEaFile rutin digunakan untuk membangun permintaan QueryEA eksplisit dan secara sinkron menunggunya selesai, mengembalikan hasilnya. Ini memungkinkan pemanggil untuk melakukan ini oleh FileObject alih-alih handel.

Sintaks

NTSTATUS FsRtlQueryKernelEaFile(
  [in]            PFILE_OBJECT FileObject,
  [out]           PVOID        ReturnedEaData,
  [in]            ULONG        Length,
  [in]            BOOLEAN      ReturnSingleEntry,
  [in]            PVOID        EaList,
  [in]            ULONG        EaListLength,
  [in, optional]  PULONG       EaIndex,
  [in]            BOOLEAN      RestartScan,
  [out, optional] PULONG       LengthReturned
);

Parameter

[in] FileObject

Penunjuk ke FileObject untuk mengirim permintaan QueryEA.

[out] ReturnedEaData

Penunjuk ke buffer output terstruktur FILE_FULL_EA_INFORMATION yang disediakan penelepon, tempat nilai atribut yang diperluas akan dikembalikan.

[in] Length

Menentukan panjang, dalam byte, dari ReturnedEaData

[in] ReturnSingleEntry

Menentukan apakah hanya satu entri yang harus dikembalikan daripada mengisi buffer dengan EA sebanyak mungkin.

[in] EaList

Penunjuk ke buffer input terstruktur FILE_GET_EA_INFORMATION yang disediakan penelepon, yang menentukan atribut yang diperluas untuk dikueri. Parameter ini bersifat opsional dan dapat berupa NULL.

[in] EaListLength

Menentukan panjang EaList, jika daftar EA disediakan.

[in, optional] EaIndex

Memasok indeks opsional EA yang nilainya akan dikembalikan. Jika ditentukan, maka hanya EA yang dikembalikan.

[in] RestartScan

Menentukan apakah pemindaian EA harus dimulai ulang dari awal.

[out, optional] LengthReturned

Menentukan jumlah data valid yang dikembalikan dalam buffer ReturnedEaData .

Nilai kembali

FsRtlQueryKernelEaFile rutin mengembalikan salah satu kode status:

Menampilkan kode	Deskripsi
STATUS_EAS_NOT_SUPPORTED	Sistem file tidak mendukung atribut yang diperluas.
STATUS_INVALID_DEVICE_REQUEST	Permintaan gagal karena perangkat langsung terbuka.
STATUS_INSUFFICIENT_RESOURCES	Paket permintaan I/O (IRP) tidak dapat dialokasikan untuk permintaan ini.
STATUS_SUCCESS	Permintaan berhasil.

Keterangan

FsRtlQueryKernelEaFile rutin ini mengasumsikan semua yang diteruskan dalam buffer berasal dari mode kernel karena mengharuskan buffer Input dan Output yang diberikan jika ditentukan, menjadi alamat mode kernel. Operasi akan gagal jika alamat mode pengguna ditentukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Target Platform	Windows
Header	ntifs.h

Lihat juga

FsRtlSetKernelEaFile

ZwQueryEaFile

ZwSetEaFile