Função FindNextFileA (fileapi.h)

Artigo
02/28/2024

Continua uma pesquisa de arquivo de uma chamada anterior para a função FindFirstFile, FindFirstFileEx ou FindFirstFileTransacted.

Sintaxe

BOOL FindNextFileA(
  [in]  HANDLE             hFindFile,
  [out] LPWIN32_FIND_DATAA lpFindFileData
);

Parâmetros

[in] hFindFile

O identificador de pesquisa retornado por uma chamada anterior para a função FindFirstFile ou FindFirstFileEx .

[out] lpFindFileData

Um ponteiro para a estrutura WIN32_FIND_DATA que recebe informações sobre o arquivo ou subdiretório encontrado.

Retornar valor

Se a função for bem-sucedida, o valor retornado será diferente de zero e o parâmetro lpFindFileData conterá informações sobre o próximo arquivo ou diretório encontrado.

Se a função falhar, o valor retornado será zero e o conteúdo de lpFindFileData será indeterminado. Para obter informações de erro estendidas, chame a função GetLastError.

Se a função falhar porque não é possível encontrar mais arquivos correspondentes, a função GetLastError retornará ERROR_NO_MORE_FILES.

Comentários

Essa função usa os mesmos filtros de pesquisa que foram usados para criar o identificador de pesquisa passado no parâmetro hFindFile . Para obter informações adicionais, consulte FindFirstFile e FindFirstFileEx.

A ordem na qual a pesquisa retorna os arquivos, como ordem alfabética, não é garantida e depende do sistema de arquivos. Se os dados precisarem ser classificados, o aplicativo deverá fazer a ordenação depois de obter todos os resultados.

Nota Em casos raros ou em um sistema fortemente carregado, as informações de atributo de arquivo em sistemas de arquivos NTFS podem não estar atuais no momento em que essa função é chamada. Para ter certeza de obter os atributos de arquivo do sistema de arquivos NTFS atuais, chame a função GetFileInformationByHandle .

A ordem na qual essa função retorna os nomes de arquivo depende do tipo de sistema de arquivos. Com o sistema de arquivos NTFS e os sistemas de arquivos CDFS, os nomes geralmente são retornados em ordem alfabética. Com sistemas de arquivos FAT, os nomes geralmente são retornados na ordem em que os arquivos foram gravados no disco, que pode ou não estar em ordem alfabética. No entanto, conforme indicado anteriormente, esses comportamentos não são garantidos.

Se o caminho apontar para um link simbólico, o buffer WIN32_FIND_DATA conterá informações sobre o link simbólico, não sobre o destino.

No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.

Tecnologia	Com suporte
Protocolo SMB (SMB) 3.0	Sim
TFO (Failover transparente) do SMB 3.0	Sim
SMB 3.0 com compartilhamentos de arquivos de expansão (SO)	Sim
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS)	Sim
ReFS (Sistema de Arquivos Resiliente)	Sim

Operações transacionadas

Se houver uma transação associada ao identificador de enumeração de arquivo, os arquivos retornados estarão sujeitos a regras de isolamento de transação.

Exemplos

Para obter um exemplo, consulte Listando os arquivos em um diretório.

Observação

O cabeçalho fileapi.h define FindNextFile 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]
Plataforma de Destino	Windows
Cabeçalho	fileapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll