Função SetVolumeMountPointA (winbase.h)
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 |