Função NetDfsAddFtRoot (lmdfs.h)
Cria um novo namespace do DFS (Sistema de Arquivos Distribuídos) baseado em domínio. Se o namespace já existir, a função adicionará o destino raiz especificado a ele.
Sintaxe
NET_API_STATUS NET_API_FUNCTION NetDfsAddFtRoot(
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[in] LPWSTR FtDfsName,
[in, optional] LPWSTR Comment,
[in] DWORD Flags
);
Parâmetros
[in] ServerName
Ponteiro para uma cadeia de caracteres que especifica o nome do servidor que hospedará o novo destino raiz do DFS. Esse valor não pode ser um endereço IP. Este parâmetro é necessário.
[in] RootShare
Ponteiro para uma cadeia de caracteres que especifica o nome da pasta compartilhada no servidor que hospedará o novo destino raiz do DFS. Este parâmetro é necessário.
[in] FtDfsName
Ponteiro para uma cadeia de caracteres que especifica o nome do namespace DFS novo ou existente baseado em domínio. Este parâmetro é necessário. Por motivos de compatibilidade, ele deve especificar a mesma cadeia de caracteres que o parâmetro RootShare .
[in, optional] Comment
Ponteiro para uma cadeia de caracteres que contém um comentário opcional associado ao namespace do DFS.
[in] Flags
Esse parâmetro é reservado e precisa ser zero.
Valor retornado
Se a função for bem-sucedida, o valor retornado será NERR_Success.
Se a função falhar, o valor retornado será um código de erro do sistema. Para obter uma lista de códigos de erro, consulte Códigos de erro do sistema.
Comentários
O compartilhamento especificado pelo parâmetro RootShare já deve existir no servidor que hospedará o novo destino raiz do DFS. Essa função não cria um novo compartilhamento.
O chamador deve ter permissão para atualizar o contêiner do DFS no serviço de diretório e deve ter privilégio de Administrador no servidor de host do DFS (raiz).
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | lmdfs.h (inclua LmDfs.h, Lm.h) |
| Biblioteca | Netapi32.lib |
| DLL | Netapi32.dll |
Confira também
Funções do DFS (Sistema de Arquivos Distribuídos)