Função FindNextVolumeA (winbase.h)

  • Artigo

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

Confira também

FindFirstVolume

FindVolumeClose

Pastas montadas

Funções de gerenciamento de volumes