Função FindFirstVolumeMountPointA (winbase.h)
Recupera o nome de uma pasta montada no volume especificado. FindFirstVolumeMountPoint é usada para começar a examinar as pastas montadas em um volume.
Sintaxe
HANDLE FindFirstVolumeMountPointA(
[in] LPCSTR lpszRootPathName,
[out] LPSTR lpszVolumeMountPoint,
[in] DWORD cchBufferLength
);
Parâmetros
[in] lpszRootPathName
Um caminho guid de volume para o volume verificar se há pastas montadas. Uma barra invertida à direita é necessária.
[out] lpszVolumeMountPoint
Um ponteiro para um buffer que recebe o nome da primeira pasta montada encontrada.
[in] cchBufferLength
O comprimento do buffer que recebe o caminho para a pasta montada, em TCHARs.
Valor retornado
Se a função for bem-sucedida, o valor retornado será um identificador de pesquisa usado em uma chamada subsequente para as funções FindNextVolumeMountPoint e FindVolumeMountPointClose .
Se a função não encontrar uma pasta montada no volume, o valor retornado será o código de erro INVALID_HANDLE_VALUE . Para obter informações de erro estendidas, chame GetLastError.
Comentários
A função FindFirstVolumeMountPoint abre um identificador de pesquisa de pasta montada e retorna informações sobre a primeira pasta montada encontrada no volume especificado. Depois que o identificador de pesquisa for estabelecido, você poderá usar a função FindNextVolumeMountPoint para pesquisar outras pastas montadas. Quando o identificador de pesquisa não for mais necessário, feche-o com a função FindVolumeMountPointClose .
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 qualquer correlação entre a ordem das pastas montadas que são retornadas por 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 | 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 Clusterizado (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.
Observação
O cabeçalho winbase.h define FindFirstVolumeMountPoint 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
| 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 |