Função NetDfsRemoveRootTarget (lmdfs.h)
Remove um destino raiz dfs de um namespace DFS baseado em domínio. Se o destino raiz for o último destino raiz no namespace dfs, essa função removerá o namespace DFS. Essa função também pode ser usada para remover um namespace dfs autônomo.
Sintaxe
NET_API_STATUS NET_API_FUNCTION NetDfsRemoveRootTarget(
[in] LPWSTR pDfsPath,
[in, optional] LPWSTR pTargetPath,
[in] ULONG Flags
);
Parâmetros
[in] pDfsPath
Ponteiro para uma cadeia de caracteres que especifica o caminho UNC (Convenção Universal de Nomenclatura) de um namespace dfs.
Para um namespace dfs autônomo, essa cadeia de caracteres deve estar na seguinte forma:
\\ Servername\DfsName
em que ServerName é o nome do servidor que hospeda o destino raiz do DFS e DfsName é o nome do namespace dfs.
Para um namespace DFS baseado em domínio, essa cadeia de caracteres deve estar no seguinte formato:
\\ Domainname\DomDfsName
em que DomainName é o nome do domínio que hospeda o namespace DFS baseado em domínio e DomDfsName é o nome do namespace dfs.
[in, optional] pTargetPath
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o caminho UNC de um destino raiz DFS para o namespace DFS especificado no parâmetro pDfsPath .
Para um namespace dfs autônomo, esse parâmetro deve ser NULL. Para um namespace DFS baseado em domínio, a cadeia de caracteres deve estar no seguinte formato:
\\ Servername\RootShare
em que ServerName é o nome do servidor que hospeda o destino raiz do DFS e RootShare é o nome da pasta no servidor.
[in] Flags
Um sinalizador que especifica o tipo de operação de remoção. Para um namespace dfs autônomo, esse parâmetro deve ser zero. Para um namespace DFS baseado em domínio, ele pode ser zero ou o valor a seguir. Se for zero, isso indicará uma operação de remoção normal.
DFS_FORCE_REMOVE (0x80000000)
Se esse sinalizador for especificado para um namespace DFS baseado em domínio, o destino raiz será removido mesmo se não estiver acessível.
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 privilégios de Administrador no servidor DFS.
A lista a seguir mostra quais valores de parâmetro você deve especificar, de acordo com o resultado desejado.
| Parâmetro pDfsPath | Parâmetro pTargetPath | Result |
|---|---|---|
| \\DomainName\DomDfsName | \\ServerName\RootShare | Exclua um modo windows 2000 ou destino raiz dfs baseado em domínio do modo Windows Server 2008. Se o destino for o último destino raiz para o namespace dfs, a função também excluirá o namespace dfs. |
| \\ServerName\DfsName | NULL | Exclua um namespace dfs autônomo. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista com SP1 |
| 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)