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 à 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 de retorno
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Se não forem encontradas 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
Observações
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, FindNextVolumeMountPointe 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 o volume GUID caminhos para um volume, consulte Enumerando caminhos guid de volume.
Você não deve assumir qualquer 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 no Windows Server 2012, essa função é compatível com as tecnologias a seguir.
| Tecnologia | Suportado |
|---|---|
| Protocolo SMB (Bloco de Mensagens do Servidor) 3.0 | Não |
| 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 de Cluster (CsvFS) | Não |
| ReFS (Sistema de Arquivos Resiliente) | Não |
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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winbase.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |
Consulte também
FindFirstVolumeMountPoint