Função NetDfsRemoveFtRoot (lmdfs.h)
Remove o destino raiz especificado de um namespace dfs (sistema de arquivos distribuído) baseado em domínio. Se o último destino raiz do namespace dfs estiver sendo removido, a função também excluirá o namespace dfs. Um namespace dfs pode ser excluído sem primeiro excluir todos os links nele.
Sintaxe
NET_API_STATUS NET_API_FUNCTION NetDfsRemoveFtRoot(
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[in] LPWSTR FtDfsName,
DWORD Flags
);
Parâmetros
[in] ServerName
Ponteiro para uma cadeia de caracteres que especifica o nome do servidor do destino raiz a ser removido. O servidor deve hospedar a raiz de um namespace DFS baseado em domínio. Este parâmetro é necessário.
[in] RootShare
Ponteiro para uma cadeia de caracteres que especifica o nome do compartilhamento de destino raiz do DFS a ser removido. Este parâmetro é necessário.
[in] FtDfsName
Ponteiro para uma cadeia de caracteres que especifica o nome do namespace DFS baseado em domínio do qual remover o destino raiz. Este parâmetro é necessário. Normalmente, é o mesmo que o parâmetro RootShare .
Flags
Esse parâmetro é reservado e precisa ser zero.
Retornar valor
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 servidor de destino raiz deve estar disponível e acessível; caso contrário, a chamada para a função NetDfsRemoveFtRoot falhará.
O chamador deve ter permissão para atualizar o contêiner dfs no serviço de diretório e deve ter privilégio de Administrador no servidor host DFS (raiz).
Requisitos
| Requisito | Valor |
|---|---|
| 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 dfs (sistema de arquivos distribuído)