Fungsi FltQueryEaFile (fltkernel.h)

Artikel
08/07/2023

FltQueryEaFile mengembalikan informasi tentang nilai extended-attribute (EA) untuk file.

Sintaks

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

Parameter

[in] Instance

Penunjuk instans buram untuk instans driver minifilter tempat operasi QueryEa akan dikirim. Instans harus dilampirkan ke volume tempat file berada.

[in] FileObject

Penunjuk objek file untuk file.

[out] ReturnedEaData

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

[in] Length

Panjang, dalam byte, dari buffer yang dituju oleh parameter ReturnedEaData .

[in] ReturnSingleEntry

Atur ke TRUE jika FltQueryEaFile hanya boleh mengembalikan entri pertama yang ditemukan.

[in, optional] 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

Panjang, dalam byte, dari buffer yang dirujuk parameter EaList .

[in, optional] EaIndex

Indeks entri untuk mulai memindai daftar atribut yang diperluas file. Parameter ini diabaikan jika parameter EaList menunjuk ke daftar yang tidak kosong. Parameter ini bersifat opsional dan dapat berupa NULL.

[in] RestartScan

Atur ke TRUE jika FltQueryEaFile harus memulai pemindaian pada entri pertama dalam daftar atribut yang diperluas file. Jika parameter ini tidak diatur ke TRUE, pemindaian dilanjutkan dari panggilan sebelumnya ke FltQueryEaFile.

[out, optional] LengthReturned

Penunjuk ke variabel yang dialokasikan penelepon yang menerima ukuran, dalam byte, dari informasi yang dikembalikan dalam buffer ReturnedEaData . Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

FltQueryEaFile mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti berikut ini:

Menampilkan kode	Deskripsi
STATUS_EAS_NOT_SUPPORTED	Sistem file tidak mendukung atribut yang diperluas. Ini adalah kode kesalahan.
STATUS_FLT_DELETING_OBJECT	Instans atau volume sedang dikoyak. Ini adalah kode kesalahan.
STATUS_INSUFFICIENT_RESOURCES	FltQueryEaFile mengalami kegagalan alokasi kumpulan. Ini adalah kode kesalahan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows 2000 Update Rollup 1 untuk SP4, Windows XP SP3, Windows Server 2003 SP1, dan versi sistem operasi Windows yang lebih baru.
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Lihat juga

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity

Bagikan melalui