FltSetEaFile function (fltkernel.h)

FltSetEaFile sets extended-attribute (EA) values for a file.

Syntax

NTSTATUS FLTAPI FltSetEaFile(
  [in] PFLT_INSTANCE Instance,
  [in] PFILE_OBJECT  FileObject,
  [in] PVOID         EaBuffer,
  [in] ULONG         Length
);

Parameters

[in] Instance

Opaque instance pointer for the minifilter driver instance that the SetEa operation is to be sent to. The instance must be attached to the volume where the file resides.

[in] FileObject

File object pointer for the file.

[in] EaBuffer

Pointer to a caller-supplied, FILE_FULL_EA_INFORMATION-structured input buffer that contains the extended attribute (EA) values to be set.

[in] Length

Length, in bytes, of the buffer that the EaBuffer parameter points to.

Return value

FltSetEaFile returns STATUS_SUCCESS or an appropriate NTSTATUS value such as the following:

Return code Description
STATUS_FLT_DELETING_OBJECT
The instance or volume is being torn down. This is an error code.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows 2000 Update Rollup 1 for SP4, Windows XP SP3, Windows Server 2003 SP1, and later versions of the Windows operating system.
Target Platform Universal
Header fltkernel.h (include Fltkernel.h)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

See also

FILE_FULL_EA_INFORMATION

FltQueryEaFile

IoCheckEaBufferValidity