NetDfsRemoveRootTarget, fonction (lmdfs.h)
Supprime une cible racine DFS d’un espace de noms DFS basé sur un domaine. Si la cible racine est la dernière cible racine dans l’espace de noms DFS, cette fonction supprime l’espace de noms DFS. Cette fonction peut également être utilisée pour supprimer un espace de noms DFS autonome.
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetDfsRemoveRootTarget(
[in] LPWSTR pDfsPath,
[in, optional] LPWSTR pTargetPath,
[in] ULONG Flags
);
Paramètres
[in] pDfsPath
Pointeur vers une chaîne qui spécifie le chemin d’accès UNC (Universal Naming Convention) d’un espace de noms DFS.
Pour un espace de noms DFS autonome, cette chaîne doit se présenter sous la forme suivante :
\\ Servername\DfsName
où ServerName est le nom du serveur qui héberge la cible racine DFS et DfsName est le nom de l’espace de noms DFS.
Pour un espace de noms DFS basé sur un domaine, cette chaîne doit se trouver sous la forme suivante :
\\ Domainname\DomDfsName
où DomainName est le nom du domaine qui héberge l’espace de noms DFS basé sur le domaine et DomDfsName est le nom de l’espace de noms DFS.
[in, optional] pTargetPath
Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le chemin UNC d’une cible racine DFS pour l’espace de noms DFS spécifié dans le paramètre pDfsPath .
Pour un espace de noms DFS autonome, ce paramètre doit être NULL. Pour un espace de noms DFS basé sur un domaine, la chaîne doit se trouver sous la forme suivante :
\\ Servername\RootShare
où ServerName est le nom du serveur qui héberge la cible racine DFS et RootShare est le nom du dossier sur le serveur.
[in] Flags
Indicateur qui spécifie le type d’opération de suppression. Pour un espace de noms DFS autonome, ce paramètre doit être égal à zéro. Pour un espace de noms DFS basé sur un domaine, il peut s’agir de zéro ou de la valeur suivante. S’il est égal à zéro, cela indique une opération de suppression normale.
DFS_FORCE_REMOVE (0x80000000)
Si cet indicateur est spécifié pour un espace de noms DFS basé sur un domaine, la cible racine est supprimée même si elle n’est pas accessible.
Valeur retournée
Si la fonction réussit, la valeur de retour est NERR_Success.
Si la fonction échoue, la valeur de retour est un code d’erreur système. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur système.
Remarques
L’appelant doit disposer de privilèges d’administrateur sur le serveur DFS.
La liste suivante indique les valeurs de paramètre que vous devez spécifier, en fonction du résultat souhaité.
| Paramètre pDfsPath | Paramètre pTargetPath | Résultats |
|---|---|---|
| \\DomainName\DomDfsName | \\ServerName\RootShare | Supprimez une cible racine DFS basée sur un domaine basée sur le mode Windows 2000 ou windows Server 2008. Si la cible est la dernière cible racine de l’espace de noms DFS, la fonction supprime également l’espace de noms DFS. |
| \\ServerName\DfsName | NULL | Supprimez un espace de noms DFS autonome. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista avec SP1 |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | lmdfs.h (include LmDfs.h, Lm.h) |
| Bibliothèque | Netapi32.lib |
| DLL | Netapi32.dll |