estrutura WIN32_FIND_DATAA (minwinbase.h)

Artigo
02/29/2024

Contém informações sobre o arquivo encontrado pela função FindFirstFile, FindFirstFileEx ou FindNextFile.

Sintaxe

typedef struct _WIN32_FIND_DATAA {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  DWORD    dwReserved0;
  DWORD    dwReserved1;
  CHAR     cFileName[MAX_PATH];
  CHAR     cAlternateFileName[14];
  DWORD    dwFileType; // Obsolete. Do not use.
  DWORD    dwCreatorType; // Obsolete. Do not use
  WORD     wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAA, *PWIN32_FIND_DATAA, *LPWIN32_FIND_DATAA;

Membros

dwFileAttributes

Os atributos de arquivo de um arquivo.

Para obter valores possíveis e suas descrições, consulte Constantes de atributo de arquivo.

O atributo FILE_ATTRIBUTE_SPARSE_FILE no arquivo será definido se algum dos fluxos do arquivo tiver sido esparso.

ftCreationTime

Uma estrutura FILETIME que especifica quando um arquivo ou diretório foi criado.

Se o sistema de arquivos subjacente não der suporte ao tempo de criação, esse membro será zero.

ftLastAccessTime

Uma estrutura FILETIME .

Para um arquivo, a estrutura especifica quando o arquivo foi lido pela última vez, gravado ou para arquivos executáveis, é executada.

Para um diretório, a estrutura especifica quando o diretório é criado. Se o sistema de arquivos subjacente não der suporte à hora do último acesso, esse membro será zero.

No sistema de arquivos FAT, a data especificada para arquivos e diretórios está correta, mas a hora do dia é sempre definida como meia-noite.

ftLastWriteTime

Uma estrutura FILETIME .

Para um arquivo, a estrutura especifica quando o arquivo foi gravado pela última vez, truncado ou substituído, por exemplo, quando WriteFile ou SetEndOfFile são usados. A data e a hora não são atualizadas quando atributos de arquivo ou descritores de segurança são alterados.

Para um diretório, a estrutura especifica quando o diretório é criado. Se o sistema de arquivos subjacente não der suporte à hora da última gravação, esse membro será zero.

nFileSizeHigh

O valor DWORD de alta ordem do tamanho do arquivo, em bytes.

Esse valor é zero, a menos que o tamanho do arquivo seja maior que MAXDWORD.

O tamanho do arquivo é igual a (nFileSizeHigh * (MAXDWORD+1)) + nFileSizeLow.

nFileSizeLow

O valor DWORD de baixa ordem do tamanho do arquivo, em bytes.

dwReserved0

Se o membro dwFileAttributes incluir o atributo FILE_ATTRIBUTE_REPARSE_POINT , esse membro especificará a marca de ponto de nova análise.

Caso contrário, esse valor é indefinido e não deve ser usado.

Para obter mais informações, consulte Reparse Point Tags.

IO_REPARSE_TAG_CSV (0x80000009)

IO_REPARSE_TAG_DEDUP (0x80000013)

IO_REPARSE_TAG_DFS (0x8000000A)

IO_REPARSE_TAG_DFSR (0x80000012)

IO_REPARSE_TAG_HSM (0xC0000004)

IO_REPARSE_TAG_HSM2 (0x80000006)

IO_REPARSE_TAG_MOUNT_POINT (0xA0000003)

IO_REPARSE_TAG_NFS (0x80000014)

IO_REPARSE_TAG_SIS (0x80000007)

IO_REPARSE_TAG_SYMLINK (0xA000000C)

IO_REPARSE_TAG_WIM (0x80000008)

dwReserved1

Reservado para uso futuro.

cFileName[MAX_PATH]

O nome do arquivo.

cAlternateFileName[14]

Um nome alternativo para o arquivo.

Esse nome está no formato de nome de arquivo clássico 8.3.

Comentários

Se um arquivo tiver um nome de arquivo longo, o nome completo aparecerá no membro cFileName e a versão truncada do formato 8.3 do nome aparecerá no membro cAlternateFileName . Caso contrário, cAlternateFileName estará vazio. Se a função FindFirstFileEx foi chamada com um valor de FindExInfoBasic no parâmetro fInfoLevelId , o membro cAlternateFileName sempre conterá um valor de cadeia de caracteres NULL . Isso permanece verdadeiro para todas as chamadas subsequentes para a função FindNextFile . Como um método alternativo de recuperação da versão de formato 8.3 de um nome de arquivo, você pode usar a função GetShortPathName . Para obter mais informações sobre nomes de arquivo, consulte Nomes de arquivo, caminhos e namespaces.

Nem todos os sistemas de arquivos podem registrar a criação e a hora do último acesso, e nem todos os sistemas de arquivos os registram da mesma maneira. Por exemplo, no sistema de arquivos FAT, o tempo de criação tem uma resolução de 10 milissegundos, o tempo de gravação tem uma resolução de 2 segundos e o tempo de acesso tem uma resolução de 1 dia. O sistema de arquivos NTFS atrasa as atualizações para a hora do último acesso de um arquivo em até 1 hora após o último acesso. Para obter mais informações, confira Horas de arquivo.

Observação

O cabeçalho minwinbase.h define WIN32_FIND_DATA como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Cabeçalho	minwinbase.h (inclua Windows.h)