Função FindFirstVolumeMountPointA (winbase.h)
Recupera o nome de uma pasta montada no volume especificado. FindFirstVolumeMountPoint é usado para começar a verificar 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 que é encontrada.
[in] cchBufferLength
O comprimento do buffer que recebe o caminho para a pasta montada, em TCHARs.
Valor de retorno
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.
Observações
A função FindFirstVolumeMountPoint
As funções FindFirstVolumeMountPoint, FindNextVolumeMountPointe FindVolumeMountPointClose retornam caminhos para pastas montadas para um volume especificado. Eles não retornam letras de unidade ou caminhos de 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 por 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 FindFirstVolumeMountPoint 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 |