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) |