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

Confira também

FindNextVolumeMountPoint

FindVolumeMountPointClose

Pastas montadas

Funções de gerenciamento de volumes