Función NetDfsRemoveFtRoot (lmdfs.h)

Artículo
08/24/2023

Quita el destino raíz especificado de un espacio de nombres del Sistema de archivos distribuido (DFS) basado en dominio. Si se quita el último destino raíz del espacio de nombres DFS, la función también elimina el espacio de nombres DFS. Se puede eliminar un espacio de nombres DFS sin eliminar primero todos los vínculos que contiene.

Sintaxis

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

Parámetros

[in] ServerName

Puntero a una cadena que especifica el nombre del servidor del destino raíz que se va a quitar. El servidor debe hospedar la raíz de un espacio de nombres DFS basado en dominio. Este parámetro es obligatorio.

[in] RootShare

Puntero a una cadena que especifica el nombre del recurso compartido de destino raíz DFS que se va a quitar. Este parámetro es obligatorio.

[in] FtDfsName

Puntero a una cadena que especifica el nombre del espacio de nombres DFS basado en dominio del que se va a quitar el destino raíz. Este parámetro es obligatorio. Normalmente, es igual que el parámetro RootShare .

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 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 servidor de destino raíz debe estar disponible y accesible; De lo contrario, se producirá un error en la llamada a la función NetDfsRemoveFtRoot .

El autor de la llamada debe tener permiso para actualizar el contenedor DFS en el servicio de directorio y debe tener privilegios de administrador en el servidor host DFS (raíz).

Requisitos

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