Función ZwSetEaFile (ntifs.h)

ZwSetEaFile reemplaza los atributos extendidos (CA) asociados a un archivo por las entidades de certificación especificadas.

Sintaxis

NTSTATUS ZwSetEaFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

Parámetros

[in] FileHandle

Identificador del archivo en el que se va a realizar la operación.

[out] IoStatusBlock

Puntero a una estructura de IO_STATUS_BLOCK que recibe el estado de finalización final y otra información sobre la operación solicitada.

[in] Buffer

Puntero a un búfer de entrada estructurado de FILE_FULL_EA_INFORMATION proporcionado por el autor de la llamada que contiene las nuevas entidades de certificación que reemplazarán las CA asociadas actualmente con el archivo.

[in] Length

Longitud, en bytes, del búfer al que apunta el parámetro Buffer .

Valor devuelto

ZwSetEaFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente:

Valor devuelto	Descripción
STATUS_EA_LIST_INCONSISTENT	La lista de EA a la que el búfer apunta a no tiene el formato correcto. Se trata de un código de error.
STATUS_INSUFFICIENT_RESOURCES	No hay suficiente memoria disponible para completar la operación. Se trata de un código de error.

Comentarios

ZwSetEaFile reemplaza las entidades de certificación asociadas a FileHandle por las entidades de búfer a las que apunta buffer . Las CA del búfer deben tener formato como una secuencia de estructuras de FILE_FULL_EA_INFORMATION . ZwSetEaFilecomprueba primero que el búfer de valores de EA es válido antes de reemplazar las ca existentes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya FltKernel.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

FILE_FULL_EA_INFORMATION

IoCheckEaBufferValidity

ZwQueryEaFile