Fungsi FsRtlSetKernelEaFile (ntifs.h)

  • Artikel

FsRtlQueryKernelEaFile rutin digunakan untuk mengatur, memodifikasi, dan/atau menghapus nilai atribut yang diperluas (EA) untuk file dan secara sinkron menunggunya selesai, mengembalikan hasilnya. Ini menetapkan kode minor IRP_MN_KERNEL yang memungkinkan API ini untuk mengatur SecureEAs. Ini memungkinkan pemanggil untuk melakukan ini oleh FileObject alih-alih handel.

Sintaks

NTSTATUS FsRtlSetKernelEaFile(
  [in] PFILE_OBJECT FileObject,
  [in] PVOID        EaBuffer,
  [in] ULONG        Length
);

Parameter

[in] FileObject

Penunjuk ke FileObject untuk mengirim permintaan QueryEA.

[in] EaBuffer

Penunjuk ke buffer input yang disediakan penelepon, FILE_FULL_EA_INFORMATION terstruktur yang berisi nilai atribut yang diperluas untuk diatur

[in] Length

Menentukan panjang buffer EA.

Nilai kembali

FsRtlSetKernelEaFile rutin menerima status operasi dan mengembalikan salah satu kode status:

Menampilkan kode Deskripsi
STATUS_EA_LIST_INCONSISTENT
Parameter EaList tidak diformat dengan benar.
STATUS_EAS_NOT_SUPPORTED
Sistem file tidak mendukung atribut yang diperluas.
STATUS_INSUFFICIENT_RESOURCES
 Paket permintaan I/O (IRP) tidak dapat dialokasikan untuk permintaan ini.
STATUS_INTERMIXED_KERNEL_EA_OPERATION
 Permintaan tidak dapat mengintermix EA normal dan kernel dalam panggilan yang sama.
STATUS_INVALID_DEVICE_REQUEST
 Permintaan gagal karena perangkat langsung terbuka.
STATUS_SUCCESS
 Permintaan berhasil.

Keterangan

Rutinitas ini mengasumsikan semua yang diteruskan dalam buffer berasal dari mode kernel.

Satu atau beberapa Kernel EA dapat diatur, dimodifikasi, dan/atau dihapus dalam satu panggilan ke FsRtlSetKernelEaFile. EA normal juga dapat diatur menggunakan fungsi FsRtlSetKernelEaFile . Anda menghapus EA dengan menentukan EAName dengan EaValueLength nol. Anda dapat melakukan intermix menyisipkan baru, memodifikasi yang sudah ada, atau menghapus EA dalam satu panggilan.

Persyaratan

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

Lihat juga

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile