Función NetDfsAddRootTarget (lmdfs.h)

Artículo
08/24/2023

Crea un espacio de nombres DFS independiente o basado en dominio o agrega un nuevo destino raíz a un espacio de nombres basado en dominio existente.

Sintaxis

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

Puntero a una cadena que especifica la ruta de acceso de convención de nomenclatura universal (UNC) de un espacio de nombres DFS.

Para un espacio de nombres DFS independiente, esta cadena debe tener el formato siguiente:

\\Nombredeservidor\DfsName

donde ServerName es el nombre del servidor que hospedará el nuevo destino raíz DFS y DfsName es el nombre del espacio de nombres DFS.

Para un espacio de nombres DFS basado en dominio, esta cadena debe tener el formato siguiente:

\\Nombrededominio\DomDfsName

donde DomainName es el nombre del dominio que hospeda el espacio de nombres DFS basado en dominio y DomDfsName es el nombre del espacio de nombres DFS basado en dominio nuevo o existente. Por motivos de compatibilidad, DomDfsName debe ser el mismo que el nombre de la carpeta compartida en el servidor que hospedará el nuevo destino raíz DFS.

[in, optional] pTargetPath

Puntero a una cadena Unicode terminada en null que especifica la ruta de acceso UNC de un destino raíz DFS para el espacio de nombres DFS especificado en el parámetro pDfsPath .

Para un espacio de nombres DFS independiente, este parámetro debe ser NULL. Para un espacio de nombres DFS basado en dominio, la cadena debe tener el formato siguiente:

\\Nombredeservidor\RootShare

donde ServerName es el nombre del servidor que hospedará el nuevo destino raíz DFS y RootShare es el nombre de la carpeta compartida en el servidor. El recurso compartido especificado por RootShare ya debe existir en el servidor que hospedará el nuevo destino raíz DFS. Esta función no crea un recurso compartido.

[in] MajorVersion

Especifica la versión de metadatos DFS para el espacio de nombres.

Nota Este parámetro solo se usa al crear un nuevo espacio de nombres.

Si se crea un espacio de nombres DFS independiente, este parámetro debe establecerse en 1.

Si se crea un espacio de nombres basado en dominio, este parámetro debe establecerse de la siguiente manera:

Establézcalo en 1 para especificar el modo de Windows 2000.
Establézcalo en 2 o superior para especificar el modo Windows Server 2008.

Si se agrega un nuevo destino raíz a un espacio de nombres DFS basado en dominio existente, este parámetro debe establecerse en cero.

[in, optional] pComment

Puntero a una cadena Unicode terminada en null que contiene un comentario asociado a la raíz DFS.

[in] Flags

Este parámetro está reservado y debe ser cero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NERR_Success.

Si el dominio no está en el nivel funcional necesario para majorVersion especificado, el valor devuelto se ERROR_DS_INCOMPATIBLE. Este valor devuelto solo se aplica a raíces de dominio y a MajorVersion de 2.

Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista de códigos de error, consulte Códigos de error del sistema.

Comentarios

El autor de la llamada debe tener privilegios de administrador en el servidor DFS.

Para determinar la versión de metadatos DFS que se puede especificar en el parámetro MajorVersion , use la función NetDfsGetSupportedNamespaceVersion .

En la tabla siguiente se muestran los valores de parámetro que debe especificar, según el resultado deseado.

Parámetro pDfsPath	Parámetro pTargetPath	Parámetro MajorVersion	Resultado
\\DomainName\DomDfsName	\\ServerName\RootShare	1	Cree un espacio de nombres DFS basado en dominio en modo Windows 2000 o agregue un nuevo destino raíz a uno existente.
\\DomainName\DomDfsName	\\ServerName\RootShare	2	Cree un espacio de nombres DFS basado en dominio basado en dominio de Windows Server 2008 o agregue un nuevo destino raíz a uno existente.
\\DomainName\DomDfsName	\\ServerName\RootShare	0	Agregue un nuevo destino raíz a un modo existente de Windows 2000 o un espacio de nombres DFS basado en dominio en modo Windows Server 2008.
\\ServerName\DfsName	NULL	Debe ser 1.	Cree un espacio de nombres DFS independiente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista con SP1
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	lmdfs.h (incluya LmDfs.h, Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll