WIN32_FIND_DATAA estrutura (minwinbase.h)
Contém informações sobre o arquivo encontrado pela função FindFirstFile, FindFirstFileExou 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 de
Para um arquivo, a estrutura especifica quando o arquivo foi lido pela última vez, gravado ou para arquivos executáveis, executado.
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 de
Para um arquivo, a estrutura especifica quando o arquivo foi gravado pela última vez, truncado ou substituído, por exemplo, quando de 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 oferecer suporte à hora da última gravação, esse membro será zero.
nFileSizeHigh
O DWORD de alta ordem valor 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 DWORD de baixa ordem valor do tamanho do arquivo, em bytes.
dwReserved0
Se o dwFileAttributes membro 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 de Marcas de Ponto de Nova Análise.
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.
Observações
Se um arquivo tiver um nome de arquivo longo, o nome completo será exibido no
Nem todos os sistemas de arquivos podem registrar a criação e os últimos tempos de 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 o último tempo de acesso de um arquivo em até 1 hora após o último acesso. Para obter mais informações, consulte de Tempos de Arquivo.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [aplicativos da área de trabalho | Aplicativos UWP] |
| servidor com suporte mínimo | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| cabeçalho | minwinbase.h (inclua Windows.h) |
Consulte também
constantes de atributo de arquivo