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.
| 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 |