Función NetDfsRemoveRootTarget (lmdfs.h)
Quita un destino raíz DFS de un espacio de nombres DFS basado en dominio. Si el destino raíz es el último destino raíz del espacio de nombres DFS, esta función quita el espacio de nombres DFS. Esta función también se puede usar para quitar un espacio de nombres DFS independiente.
Sintaxis
NET_API_STATUS NET_API_FUNCTION NetDfsRemoveRootTarget(
[in] LPWSTR pDfsPath,
[in, optional] LPWSTR pTargetPath,
[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 hospeda el 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.
[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 hospeda el destino raíz DFS y RootShare es el nombre de la carpeta en el servidor.
[in] Flags
Marca que especifica el tipo de operación de eliminación. Para un espacio de nombres DFS independiente, este parámetro debe ser cero. Para un espacio de nombres DFS basado en dominio, puede ser cero o el valor siguiente. Si es cero, esto indica una operación de eliminación normal.
DFS_FORCE_REMOVE (0x80000000)
Si se especifica esta marca para un espacio de nombres DFS basado en dominio, el destino raíz se quita incluso si no es accesible.
Valor devuelto
Si la función se realiza 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 privilegios de administrador en el servidor DFS.
En la lista siguiente se muestran los valores de parámetro que debe especificar, según el resultado deseado.
| Parámetro pDfsPath | Parámetro pTargetPath | Resultado |
|---|---|---|
| \\DomainName\DomDfsName | \\ServerName\RootShare | Elimina un modo de Windows 2000 o un destino raíz de DFS basado en dominio del modo Windows Server 2008. Si el destino es el último destino raíz para el espacio de nombres DFS, la función también elimina el espacio de nombres DFS. |
| \\ServerName\DfsName | NULL | Elimine 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 (include LmDfs.h, Lm.h) |
| Library | Netapi32.lib |
| Archivo DLL | Netapi32.dll |
Consulte también
Funciones del sistema de archivos distribuido (DFS)