Função FindNextVolumeMountPointA (winbase.h)

Continua uma pesquisa de pasta montada iniciada por uma chamada para a função FindFirstVolumeMountPoint. FindNextVolumeMountPoint localiza uma pasta montada por chamada.

Sintaxe

BOOL FindNextVolumeMountPointA(
  [in]  HANDLE hFindVolumeMountPoint,
  [out] LPSTR  lpszVolumeMountPoint,
  [in]  DWORD  cchBufferLength
);

Parâmetros

[in] hFindVolumeMountPoint

Um identificador de pesquisa de pasta montado retornado por uma chamada anterior para a função FindFirstVolumeMountPoint .

[out] lpszVolumeMountPoint

Um ponteiro para um buffer que recebe o nome da pasta montada encontrada.

[in] cchBufferLength

O comprimento do buffer que recebe o nome da pasta montada, 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 não for possível encontrar mais pastas montadas, a função GetLastError retornará o código de erro ERROR_NO_MORE_FILES . Nesse caso, feche a pesquisa com a função FindVolumeMountPointClose .

Comentários

Depois que o identificador de pesquisa for estabelecido chamando FindFirstVolumeMountPoint, você poderá usar a função FindNextVolumeMountPoint para pesquisar outras pastas montadas.

As funções FindFirstVolumeMountPoint, FindNextVolumeMountPoint e FindVolumeMountPointClose retornam caminhos para pastas montadas para um volume especificado. Eles não retornam letras de unidade ou caminhos GUID de volume. Para obter informações sobre como enumerar os caminhos guid de volume para um volume, consulte Enumerando caminhos guid de volume.

Você não deve assumir nenhuma correlação entre a ordem das pastas montadas que são retornadas com essas funções e a ordem das pastas montadas que são retornadas por outras funções ou ferramentas.

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)	No
ReFS (Sistema de Arquivos Resiliente)	No

 

O SMB não dá suporte a funções de gerenciamento de volume. O CsvFS não dá suporte à adição de ponto de montagem em um volume CSV. O ReFS não indexa pontos de montagem.

Observação

O cabeçalho winbase.h define FindNextVolumeMountPoint como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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

FindFirstVolumeMountPoint

FindVolumeMountPointClose

Pastas montadas

Funções de gerenciamento de volumes