Função NetDfsRemoveFtRootForced (lmdfs.h)

Remove o destino raiz especificado de um namespace do DFS (Sistema de Arquivos Distribuídos) baseado em domínio, mesmo que o servidor de destino raiz esteja offline. Se o último destino raiz do namespace do DFS estiver sendo removido, a função também excluirá o namespace do DFS. Um namespace dfs pode ser excluído sem primeiro excluir todos os links nele.

Nota A função NetDfsRemoveFtRootForced não atualiza o registro no servidor de destino raiz do DFS. Para obter mais informações, consulte a seção Comentários.

 

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetDfsRemoveFtRootForced(
  [in] LPWSTR DomainName,
  [in] LPWSTR ServerName,
  [in] LPWSTR RootShare,
  [in] LPWSTR FtDfsName,
       DWORD  Flags
);

Parâmetros

[in] DomainName

Ponteiro para uma cadeia de caracteres que especifica o nome do domínio do Active Directory que contém o namespace DFS baseado em domínio a ser removido. Este parâmetro é necessário.

[in] ServerName

Ponteiro para uma cadeia de caracteres que especifica o nome do servidor de destino raiz do DFS a ser removido. O servidor deve hospedar uma raiz do 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, ele é o mesmo que o parâmetro RootShare .

Flags

Deve 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 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).

A função NetDfsRemoveFtRootForced remove à força um destino raiz dfs baseado em domínio de um namespace dfs. Ele é usado para excluir um namespace DFS baseado em domínio quando os servidores de destino raiz do namespace não estão mais disponíveis (por exemplo, porque foram desativados).

Como o destino raiz do DFS é removido entrando em contato com o PDC (controlador de domínio primário) e não removendo o servidor de destino raiz do DFS, o NetDfsRemoveFtRootForced não atualiza o registro do servidor de destino raiz. Em circunstâncias normais, você pode remover o destino raiz de uma raiz de domínio DFS chamando a função NetDfsRemoveFtRoot .

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 do DFS (Sistema de Arquivos Distribuídos)

NetDfsAddFtRoot

NetDfsRemoveFtRoot

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede