Função FindNextFileNameW (fileapi.h)

  • Artigo

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.

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

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho fileapi.h (inclua Windows.h, WinBase.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções de gerenciamento de arquivos

FindClose

FindFirstFileNameW