estructura de FILE_ID_GLOBAL_TX_DIR_INFORMATION (ntifs.h)

  • Artículo

La estructura FILE_ID_GLOBAL_TX_DIR_INFORMATION contiene información sobre la visibilidad transaccional de los archivos de un directorio.

Sintaxis

typedef struct _FILE_ID_GLOBAL_TX_DIR_INFORMATION {
  ULONG         NextEntryOffset;
  ULONG         FileIndex;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER EndOfFile;
  LARGE_INTEGER AllocationSize;
  ULONG         FileAttributes;
  ULONG         FileNameLength;
  LARGE_INTEGER FileId;
  GUID          LockingTransactionId;
  ULONG         TxInfoFlags;
  WCHAR         FileName[1];
} FILE_ID_GLOBAL_TX_DIR_INFORMATION, *PFILE_ID_GLOBAL_TX_DIR_INFORMATION;

Miembros

NextEntryOffset

Desplazamiento de bytes desde el principio de esta entrada, en el que se encuentra la siguiente entrada FILE_ID_FULL_DIR_INFORMATION si hay varias entradas presentes en un búfer. Un valor de cero indica que ninguna otra entrada sigue esta.

FileIndex

Desplazamiento de bytes del archivo dentro del directorio primario. En el caso de los sistemas de archivos en los que la posición de un archivo dentro del directorio primario no es fijo y se puede cambiar para mantener el criterio de ordenación, este campo debe establecerse en 0 y se omite.

CreationTime

Hora en que se creó el archivo.

LastAccessTime

La última vez que se obtuvo acceso al archivo.

LastWriteTime

La última vez que se escribió información en el archivo.

ChangeTime

La última vez que se cambió el archivo.

EndOfFile

Posición absoluta del final del archivo como desplazamiento de bytes desde el inicio del archivo. EndOfFile especifica el desplazamiento al byte inmediatamente después del último byte válido del archivo.

AllocationSize

Tamaño de asignación de archivos en bytes. El valor de este campo es un número entero múltiplo del tamaño del clúster.

FileAttributes

Atributos de archivo.

Marca Significado
FILE_ATTRIBUTE_NORMAL Se debe crear un archivo que tenga atributos estándar.
FILE_ATTRIBUTE_READONLY Se debe crear un archivo de solo lectura.
FILE_ATTRIBUTE_HIDDEN Se debe crear un archivo oculto.
FILE_ATTRIBUTE_SYSTEM Se debe crear un archivo del sistema.
FILE_ATTRIBUTE_ARCHIVE El archivo debe marcarse para que se archive.
FILE_ATTRIBUTE_TEMPORARY Se debe crear un archivo temporal.

FileNameLength

Longitud, en bytes, del nombre de archivo contenido en el miembro FileName .

FileId

Número de referencia de archivo para el archivo. El sistema de archivos genera este número y lo asigna al archivo. En el caso de los sistemas de archivos que no admiten FileId, este campo se establece en 0 y se omite.

LockingTransactionId

Valor GUID de la transacción que tiene este archivo bloqueado para su modificación. El sistema de archivos genera y asigna este valor.

TxInfoFlags

OR bit a bit de cero o más de los valores siguientes.

Valor Significado
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED 0x00000001 El archivo está bloqueado para su modificación mediante una transacción. El identificador de la transacción debe estar incluido en el miembro LockingTransactionId si se establece esta marca.
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_TO_TX 0x00000002 El archivo es visible para enumeradores transaccionados del directorio cuyo identificador de transacción está en el miembro LockingTransactionId .
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_OUTSIDE_TX 0x00000004 El archivo es visible para los enumeradores de transacciones del directorio distinto del que tiene el identificador de transacción en el miembro LockingTransactionId y es visible para los enumeradores no transaccionados del directorio.
 

Si no se establece la marca de FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED, no se deben establecer las demás marcas. Si se establecen marcas distintas de FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED, se debe establecer la marca de FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED.

FileName[1]

Secuencia de caracteres Unicode que contienen el nombre de archivo.

Nota Use FileNameLength para determinar la longitud del nombre de archivo en lugar de asumir la presencia de un delimitador NULO final.
 

Comentarios

La estructura FILE_ID_GLOBAL_TX_DIR_INFORMATION se puede implementar para los sistemas de archivos que devuelven la marca FILE_SUPPORTS_TRANSACTIONS en respuesta a una consulta mediante una estructura de FILE_FS_ATTRIBUTE_INFORMATION . No debe implementarse para sistemas de archivos que no devuelvan esa marca.

Si la marca FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED no está establecida en TxInfoFlags, se omite LockingTransactionId .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7
Encabezado ntifs.h (incluya FltKernel.h, Ntifs.h)