ZwSetEaFile

  • Article

The ZwSetEaFile routine sets extended-attribute (EA) values for a file.

Syntax

NTSTATUS ZwSetEaFile(
  __in   HANDLE FileHandle,
  __out  PIO_STATUS_BLOCK IoStatusBlock,
  __in   PVOID Buffer,
  __in   ULONG Length
);

Parameters

  • FileHandle [in]
    The handle for the file on which the operation is to be performed.

  • IoStatusBlock [out]
    A pointer to an IO_STATUS_BLOCK structure that receives the final completion status and other information about the requested operation.

  • Buffer [in]
    A pointer to a caller-supplied, FILE_FULL_EA_INFORMATION-structured input buffer that contains the extended attribute values to be set.

  • Length [in]
    Length, in bytes, of the buffer that the Buffer parameter points to.

Return Value

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

Return value Description
STATUS_EA_LIST_INCONSISTENT

The EaList parameter is not formatted correctly. This is an error code.

 

Requirements

Version

 Available in Microsoft Windows 2000 and later versions of the Windows operating system.

Header

 Ntifs.h (include FltKernel.h or Ntifs.h)

Library

 Ntoskrnl.lib

IRQL

 PASSIVE_LEVEL

See Also

FILE_FULL_EA_INFORMATION

ZwQueryEaFile

 

 

Send comments about this topic to Microsoft

Build date: 6/3/2010