Função FindNextFileNameW (fileapi.h)

Continua enumerando os links físicos para um arquivo usando o identificador retornado por uma chamada bem-sucedida para a função FindFirstFileNameW.

Sintaxe

BOOL FindNextFileNameW(
  [in]      HANDLE  hFindStream,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Parâmetros

[in] hFindStream

Um identificador para a enumeração retornada por uma chamada bem-sucedida para FindFirstFileNameW.

[in, out] StringLength

O tamanho do parâmetro LinkName , em caracteres. Se essa chamada falhar e o erro for ERROR_MORE_DATA, o valor retornado por esse parâmetro será o tamanho que LinkName deve conter todos os dados.

[in, out] LinkName

Um ponteiro para um buffer para armazenar o nome do primeiro link encontrado para lpFileName.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será 0 (zero). Para obter informações de erro estendidas, chame GetLastError.

Se nenhum arquivo correspondente puder ser encontrado, a função GetLastError retornará ERROR_HANDLE_EOF.

Comentários

Se a função retornar TRUE, haverá mais links rígidos para enumerar.

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

Requisitos

Confira também

Funções de gerenciamento de arquivos

FindClose

FindFirstFileNameW