estructura FILE_NOTIFY_FULL_INFORMATION (ntifs.h)

Artículo
02/06/2024

Se devuelve una estructura FILE_NOTIFY_FULL_INFORMATION en respuesta a una solicitud de IRP_MJ_DIRECTORY_CONTROL con un código de función secundaria IRP_MN_NOTIFY_CHANGE_DIRECTORY cuando DIRECTORY_NOTIFY_INFORMATION_CLASS es DirectoryNotifyFullInformation.

Sintaxis

typedef struct _FILE_NOTIFY_FULL_INFORMATION {
  ULONG         NextEntryOffset;
  ULONG         Action;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastModificationTime;
  LARGE_INTEGER LastChangeTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER AllocatedLength;
  LARGE_INTEGER FileSize;
  ULONG         FileAttributes;
  union {
    ULONG ReparsePointTag;
    ULONG EaSize;
  } DUMMYUNIONNAME;
  LARGE_INTEGER FileId;
  LARGE_INTEGER ParentFileId;
  USHORT        FileNameLength;
  UCHAR         FileNameFlags;
  UCHAR         Reserved;
  WCHAR         FileName[1];
} FILE_NOTIFY_FULL_INFORMATION, *PFILE_NOTIFY_FULL_INFORMATION;

Miembros

NextEntryOffset

Número de bytes que se deben omitir para llegar al siguiente registro. Un valor de cero indica que este es el último registro.

Action

Tipo de cambio que se ha producido. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
FILE_ACTION_ADDED (0x00000001)	Se agregó un archivo al directorio .
FILE_ACTION_REMOVED (0x00000002)	Se quitó un archivo del directorio .
FILE_ACTION_MODIFIED (0x00000003)	Se modificó el directorio. Puede ser un cambio en la marca de tiempo o los atributos.
FILE_ACTION_RENAMED_OLD_NAME (0x00000004)	Se cambió el nombre del directorio y este es el nombre anterior.
FILE_ACTION_RENAMED_NEW_NAME (0x00000005)	Se ha cambiado el nombre del directorio y se trata del nuevo nombre.

CreationTime

Fecha y hora en que se creó el directorio o archivo y se agregó al sistema de archivos.

LastModificationTime

Fecha y hora en que el contenido del directorio o archivo se modificó por última vez en el sistema de archivos.

LastChangeTime

Fecha y hora en que los metadatos o el contenido del directorio o archivo se cambiaron por última vez en el sistema de archivos.

LastAccessTime

Fecha y hora en que se obtuvo acceso por última vez al directorio o archivo en el sistema de archivos.

AllocatedLength

Tamaño asignado del archivo, en bytes.

FileSize

Nuevo tamaño del directorio o archivo en bytes, o el tamaño anterior si el tamaño no cambia.

FileAttributes

Atributos de archivo, que pueden ser cualquier combinación válida de lo siguiente:

FILE_ATTRIBUTE_READONLY
FILE_ATTRIBUTE_HIDDEN
FILE_ATTRIBUTE_SYSTEM
FILE_ATTRIBUTE_DIRECTORY
FILE_ATTRIBUTE_ARCHIVE
FILE_ATTRIBUTE_NORMAL
FILE_ATTRIBUTE_TEMPORARY
FILE_ATTRIBUTE_COMPRESSED

DUMMYUNIONNAME

DUMMYUNIONNAME.ReparsePointTag

Etiqueta de identificador de un punto de reanálisis para el directorio o archivo.

DUMMYUNIONNAME.EaSize

Longitud combinada de los atributos extendidos (EA) del archivo, en bytes.

FileId

Identificador del directorio o archivo. El sistema de archivos genera y asigna este número al archivo.

ParentFileId

Identificador del directorio primario del archivo.

FileNameLength

Tamaño de la parte del nombre de archivo del registro, en bytes. Este valor no incluye un carácter nulo de terminación.

FileNameFlags

Marcas que especifican qué tipo de nombre de archivo se devuelve, si se conoce. Si no se establece ninguna de las marcas siguientes, no se conoce el tipo de nombre de archivo. Si se establecen las dos marcas siguientes, el nombre de archivo actúa como el nombre largo y el nombre corto (tanto el nombre NTFS como el nombre DOS) de un par de nombres largos y cortos.

Marca	Value
FILE_NAME_NTFS (0x01)	El nombre de archivo es el nombre largo (nombre NTFS) de un par de nombres largos y cortos.
FILE_NAME_DOS (0x02)	El nombre de archivo es el nombre corto (nombre DOS) de un par de nombres largos y cortos.

Reserved

Reservado para uso del sistema.

FileName[1]

Campo de longitud variable que contiene el nombre de archivo relativo al identificador de directorio. El nombre de archivo tiene el formato de caracteres Unicode y no termina en null.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 11, versión 22H2
Encabezado	ntifs.h

Consulte también

DIRECTORY_NOTIFY_INFORMATION_CLASS

IRP_MJ_DIRECTORY_CONTROL

ZwNotifyChangeDirectoryFileEx

Share via