estrutura FILE_ID_GLOBAL_TX_DIR_INFORMATION (ntifs.h)

  • Artigo

A estrutura FILE_ID_GLOBAL_TX_DIR_INFORMATION contém informações sobre visibilidade transacional para os arquivos em um diretório.

Sintaxe

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;

Membros

NextEntryOffset

O deslocamento de bytes do início dessa entrada, no qual a próxima entrada FILE_ID_FULL_DIR_INFORMATION está localizada se várias entradas estiverem presentes em um buffer. Um valor zero indica que nenhuma outra entrada segue esta.

FileIndex

O deslocamento de bytes do arquivo no diretório pai. Para sistemas de arquivos nos quais a posição de um arquivo dentro do diretório pai não é corrigida e pode ser alterada para manter a ordem de classificação, esse campo deve ser definido como 0 e é ignorado.

CreationTime

A hora em que o arquivo foi criado.

LastAccessTime

A última vez que o arquivo foi acessado.

LastWriteTime

A última vez que as informações foram gravadas no arquivo.

ChangeTime

A última vez que o arquivo foi alterado.

EndOfFile

A nova posição de fim de arquivo absoluta como um deslocamento de bytes desde o início do arquivo. EndOfFile especifica o deslocamento para o byte imediatamente após o último byte válido no arquivo.

AllocationSize

O tamanho da alocação de arquivo em bytes. O valor desse campo é um múltiplo inteiro do tamanho do cluster.

FileAttributes

Os atributos de arquivo.

Sinalizador Significado
FILE_ATTRIBUTE_NORMAL Um arquivo que tenha atributos padrão deve ser criado.
FILE_ATTRIBUTE_READONLY Um arquivo somente leitura deve ser criado.
FILE_ATTRIBUTE_HIDDEN Um arquivo oculto deve ser criado.
FILE_ATTRIBUTE_SYSTEM Um arquivo do sistema deve ser criado.
FILE_ATTRIBUTE_ARCHIVE O arquivo deve ser marcado para que ele seja arquivado.
FILE_ATTRIBUTE_TEMPORARY Um arquivo temporário deve ser criado.

FileNameLength

O comprimento, em bytes, do nome do arquivo contido no membro FileName .

FileId

Um número de referência de arquivo para o arquivo. O sistema de arquivos gera esse número e o atribui ao arquivo. Para sistemas de arquivos que não dão suporte a FileId, esse campo é definido como 0 e ignorado.

LockingTransactionId

Um valor GUID da transação que tem esse arquivo bloqueado para modificação. O sistema de arquivos gera e atribui esse valor.

TxInfoFlags

Um OR bit a bit de zero ou mais dos valores a seguir.

Valor Significado
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED 0x00000001 O arquivo está bloqueado para modificação por uma transação. A ID da transação deve estar contida no membro LockingTransactionId se esse sinalizador estiver definido.
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_TO_TX 0x00000002 O arquivo é visível para enumeradores transacionados do diretório cuja ID de transação está no membro LockingTransactionId .
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_OUTSIDE_TX 0x00000004 O arquivo é visível para enumeradores transacionados do diretório diferente do cuja ID de transação está no membro LockingTransactionId e fica visível para enumeradores não transacionados do diretório.
 

Se o sinalizador FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED não estiver definido, os outros sinalizadores não deverão ser definidos. Se sinalizadores diferentes de FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED estiverem definidos, o sinalizador FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED deverá ser definido.

FileName[1]

Uma sequência de caracteres Unicode que contém o nome do arquivo.

Nota Use FileNameLength para determinar o comprimento do nome do arquivo em vez de assumir a presença de um delimitador nulo à direita.
 

Comentários

A estrutura FILE_ID_GLOBAL_TX_DIR_INFORMATION pode ser implementada para sistemas de arquivos que retornam o sinalizador FILE_SUPPORTS_TRANSACTIONS em resposta a uma consulta usando uma estrutura de FILE_FS_ATTRIBUTE_INFORMATION . Ele não deve ser implementado para sistemas de arquivos que não retornam esse sinalizador.

Se o sinalizador FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED não estiver definido em TxInfoFlags, LockingTransactionId será ignorado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7
Cabeçalho ntifs.h (inclua FltKernel.h, Ntifs.h)