Función ZwSetEaFile (ntifs.h)
ZwSetEaFile reemplaza los atributos extendidos (EAs) 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 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_INFORMATIONproporcionado por el autor de la llamada que contiene las nuevas ENTIDADES de certificación que reemplazarán las entidades de certificación asociadas actualmente al archivo.
[in] Length
Longitud, en bytes, del búfer al que apunta el buffer parámetro.
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 apunta buffer 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. |
Observaciones
ZwSetEaFile reemplaza las entidades de certificación asociadas a fileHandle por las entidades de certificación del búfer a las que apunta buffer. Los EA del búfer deben tener formato como una secuencia de estructuras de FILE_FULL_EA_INFORMATION. ZwSetEaFile primero comprueba que el búfer de valores de EA sea válido antes de reemplazar las entidades de certificación existentes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 |
| de la plataforma de destino de |
Universal |
| encabezado de |
ntifs.h (include FltKernel.h, Ntifs.h) |
| biblioteca de |
NtosKrnl.lib |
| DLL de |
NtosKrnl.exe |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |