estructura de FILE_ID_GLOBAL_TX_DIR_INFORMATION (ntifs.h)
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.
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) |