Função FindNextVolumeA (winbase.h)
Continua uma pesquisa de volume iniciada por uma chamada para a função FindFirstVolume. FindNextVolume localiza um volume por chamada.
Sintaxe
BOOL FindNextVolumeA(
[in] HANDLE hFindVolume,
[out] LPSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parâmetros
[in] hFindVolume
O identificador de pesquisa de volume retornado por uma chamada anterior para a função FindFirstVolume .
[out] lpszVolumeName
Um ponteiro para uma cadeia de caracteres que recebe o caminho guid do volume encontrado.
[in] cchBufferLength
O comprimento do buffer que recebe o caminho guid do volume, em TCHARs.
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á zero. Para obter informações de erro estendidas, chame GetLastError. Se nenhum arquivo correspondente puder ser encontrado, a função GetLastError retornará o código de erro ERROR_NO_MORE_FILES . Nesse caso, feche a pesquisa com a função FindVolumeClose .
Comentários
Depois que o identificador de pesquisa for estabelecido chamando FindFirstVolume, você poderá usar a função FindNextVolume para pesquisar outros volumes.
Você não deve assumir nenhuma correlação entre a ordem dos volumes retornados por essas funções e a ordem dos volumes que estão no computador. Em particular, não assuma nenhuma correlação entre a ordem do volume e as letras da unidade, conforme atribuído pelo BIOS (se houver) ou pelo Administrador de Disco.
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 | No |
| TFO (Failover transparente) do SMB 3.0 | No |
| SMB 3.0 com compartilhamentos de arquivos de expansão (SO) | No |
| Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) | Sim |
| ReFS (Sistema de Arquivos Resiliente) | Sim |
O SMB não dá suporte a funções de gerenciamento de volume.
Exemplos
Para obter um exemplo, consulte Exibindo caminhos de volume.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (incluir Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |