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
Valor de retorno
Se a função for bem-sucedida, o valor retornado não será 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
Observações
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 o sistema e diretórios ocultos, bem como outros diretórios, e ocorre para arquivos ocultos e de 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 de unidade.
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. 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.
Nota
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 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 |
Consulte também
GetVolumeNameForVolumeMountPoint
GetVolumePathName