NetDfsRemoveFtRoot, fonction (lmdfs.h)
Supprime la cible racine spécifiée d’un espace de noms DFS (Distributed File System) basé sur un domaine. Si la dernière cible racine de l’espace de noms DFS est supprimée, la fonction supprime également l’espace de noms DFS. Un espace de noms DFS peut être supprimé sans supprimer au préalable tous les liens qu’il contient.
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetDfsRemoveFtRoot(
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[in] LPWSTR FtDfsName,
DWORD Flags
);
Paramètres
[in] ServerName
Pointeur vers une chaîne qui spécifie le nom de serveur de la cible racine à supprimer. Le serveur doit héberger la racine d’un espace de noms DFS basé sur un domaine. Ce paramètre est obligatoire.
[in] RootShare
Pointeur vers une chaîne qui spécifie le nom du partage cible racine DFS à supprimer. Ce paramètre est obligatoire.
[in] FtDfsName
Pointeur vers une chaîne qui spécifie le nom de l’espace de noms DFS basé sur un domaine à partir duquel supprimer la cible racine. Ce paramètre est obligatoire. En règle générale, il est identique au paramètre RootShare .
Flags
Ce paramètre est réservé et doit être égal à zéro.
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
Le serveur cible racine doit être disponible et accessible ; sinon, l’appel à la fonction NetDfsRemoveFtRoot échoue.
L’appelant doit être autorisé à mettre à jour le conteneur DFS dans le service d’annuaire et doit disposer du privilège Administrateur sur le serveur hôte DFS (racine).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| 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 |