Função FindNextVolumeW (fileapi.h)

Continua uma pesquisa de volume iniciada por uma chamada para a função FindFirstVolume. FindNextVolume localiza um volume por chamada.

Sintaxe

BOOL FindNextVolumeW(
  [in]  HANDLE hFindVolume,
  [out] LPWSTR 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 de volume encontrado.

[in] cchBufferLength

O comprimento do buffer que recebe o caminho guid de 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 qualquer 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.

O SMB não dá suporte a funções de gerenciamento de volume.

Exemplos

Para obter um exemplo, consulte Exibindo caminhos de volume.

Requisitos

Confira também

FindFirstVolume

FindVolumeClose

Pastas montadas

Funções de gerenciamento de volumes