Função NetDfsAddRootTarget (lmdfs.h)

Artigo
08/24/2023

Cria um namespace DFS baseado em domínio ou autônomo ou adiciona um novo destino raiz a um namespace baseado em domínio existente.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetDfsAddRootTarget(
  [in]           LPWSTR pDfsPath,
  [in, optional] LPWSTR pTargetPath,
  [in]           ULONG  MajorVersion,
  [in, optional] LPWSTR pComment,
  [in]           ULONG  Flags
);

Parâmetros

[in] pDfsPath

Ponteiro para uma cadeia de caracteres que especifica o caminho UNC (Convenção de Nomenclatura Universal) de um namespace dfs.

Para um namespace dfs autônomo, essa cadeia de caracteres deve estar no seguinte formato:

\\ Servername\DfsName

em que ServerName é o nome do servidor que hospedará o novo 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 novo ou existente baseado em domínio. Por motivos de compatibilidade, DomDfsName deve ser o mesmo que o nome da pasta compartilhada no servidor que hospedará o novo destino raiz do 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 hospedará o novo destino raiz do DFS e RootShare é o nome da pasta compartilhada no servidor. O compartilhamento especificado por RootShare já deve existir no servidor que hospedará o novo destino raiz do DFS. Essa função não cria um novo compartilhamento.

[in] MajorVersion

Especifica a versão de metadados do DFS para o namespace.

Nota Esse parâmetro só é usado ao criar um novo namespace.

Se um namespace DFS autônomo estiver sendo criado, esse parâmetro deverá ser definido como 1.

Se um namespace baseado em domínio estiver sendo criado, esse parâmetro deverá ser definido da seguinte maneira:

Defina-o como 1 para especificar o modo windows 2000.
Defina-o como 2 ou superior para especificar o modo do Windows Server 2008.

Se um novo destino raiz estiver sendo adicionado a um namespace DFS baseado em domínio existente, esse parâmetro deverá ser definido como zero.

[in, optional] pComment

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém um comentário associado à raiz DFS.

[in] 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 o domínio não estiver no nível funcional necessário para o MajorVersion especificado, o valor retornado será ERROR_DS_INCOMPATIBLE. Esse valor retornado se aplica somente às raízes de domínio e a uma MajorVersion de 2.

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égio de Administrador no servidor DFS.

Para determinar a versão de metadados do DFS que pode ser especificada no parâmetro MajorVersion , use a função NetDfsGetSupportedNamespaceVersion .

A tabela a seguir mostra quais valores de parâmetro você deve especificar, de acordo com o resultado desejado.

Parâmetro pDfsPath	Parâmetro pTargetPath	Parâmetro MajorVersion	Result
\\DomainName\DomDfsName	\\ServerName\RootShare	1	Crie um namespace DFS baseado no domínio do modo Windows 2000 ou adicione um novo destino raiz a um existente.
\\DomainName\DomDfsName	\\ServerName\RootShare	2	Crie um namespace DFS baseado no domínio do modo Windows Server 2008 ou adicione um novo destino raiz a um existente.
\\DomainName\DomDfsName	\\ServerName\RootShare	0	Adicione um novo destino raiz a um modo existente do Windows 2000 ou ao namespace DFS do modo windows server 2008.
\\ServerName\DfsName	NULL	Deve ser 1.	Crie 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