Função SetVolumeMountPointA (winbase.h)

Artigo
08/27/2023

Associa um volume a uma letra de unidade ou a um diretório em outro volume.

Sintaxe

BOOL SetVolumeMountPointA(
  [in] LPCSTR lpszVolumeMountPoint,
  [in] LPCSTR lpszVolumeName
);

Parâmetros

[in] lpszVolumeMountPoint

O caminho do modo de usuário a ser associado ao volume. Pode ser uma letra de unidade (por exemplo, "X:\") ou um diretório em outro volume (por exemplo, "Y:\MountX"). A cadeia de caracteres deve terminar com uma barra invertida à direita ('').

[in] lpszVolumeName

Um caminho GUID de volume para o volume. Essa cadeia de caracteres deve ser do formulário "\\?\Volume{GUID}" em que GUID é um GUID que identifica o volume. O "\\?" desativa a análise de caminho e é ignorado como parte do caminho, conforme discutido em Nomear um volume.

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 o parâmetro lpszVolumeMountPoint contiver um caminho para uma pasta montada, GetLastError retornará ERROR_DIR_NOT_EMPTY, mesmo que o diretório esteja vazio.

Comentários

Quando essa função é usada para associar um volume a um diretório em outro volume, o diretório associado é chamado de pasta montada.

É um erro associar um volume a um diretório que tenha arquivos ou subdiretórios nele. Esse erro ocorre para diretórios ocultos e do sistema, bem como para outros diretórios, e ocorre para arquivos ocultos e do sistema.

Quando pastas montadas são criadas em um volume em um disco clusterizado, elas podem ser excluídas inesperadamente em determinadas circunstâncias. Para obter informações sobre como criar e configurar pastas montadas para garantir que isso não aconteça, consulte Problemas de conexão de disco de cluster e unidade.

No Windows 8 e no 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. Para CsvFS, um novo ponto de montagem não será replicado para os outros nós no cluster.

Exemplos

Para obter um exemplo, consulte Criando uma pasta montada.

Observação

O cabeçalho winbase.h define SetVolumeMountPoint 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 (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll