Compartir a través de

Función NetDfsRemoveFtRootForced (lmdfs.h)

  • Artículo

Quita el destino raíz especificado de un espacio de nombres del Sistema de archivos distribuido (DFS) basado en dominio, incluso si el servidor de destino raíz está sin conexión. 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.

Nota La función NetDfsRemoveFtRootForced no actualiza el registro en el servidor de destino raíz DFS. Para obtener más información, vea la sección Comentarios.
 

Sintaxis

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

Puntero a una cadena que especifica el nombre del dominio de Active Directory que contiene el espacio de nombres DFS basado en dominio que se va a quitar. Este parámetro es obligatorio.

[in] ServerName

Puntero a una cadena que especifica el nombre del servidor de destino raíz DFS que se va a quitar. El servidor debe hospedar una raíz del 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

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

La función NetDfsRemoveFtRootForced quita forzosamente un destino raíz DFS basado en dominio de un espacio de nombres DFS. Se usa para eliminar un espacio de nombres DFS basado en dominio cuando los servidores de destino raíz del espacio de nombres ya no están disponibles (por ejemplo, porque se han retirado).

Dado que el destino raíz DFS se quita poniéndose en contacto con el controlador de dominio principal (PDC) y no quitando el servidor de destino raíz DFS, NetDfsRemoveFtRootForced no actualiza el registro del servidor de destino raíz. En circunstancias normales, puede quitar el destino raíz de una raíz de dominio DFS mediante una llamada a la función NetDfsRemoveFtRoot .

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

Consulte también

Funciones del sistema de archivos distribuido (DFS)

NetDfsAddFtRoot

NetDfsRemoveFtRoot

Funciones de administración de redes

Introducción a la administración de redes