NetDfsRemoveFtRootForced, fonction (lmdfs.h)

Article
02/28/2024

Supprime la cible racine spécifiée d’un espace de noms DFS (Distributed File System) basé sur un domaine, même si le serveur cible racine est hors connexion. Si la dernière cible racine de l’espace de noms DFS est en cours de suppression, 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.

Note La fonction NetDfsRemoveFtRootForced ne met pas à jour le Registre sur le serveur cible racine DFS. Pour plus d'informations, consultez la section Notes.

Syntaxe

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

Paramètres

[in] DomainName

Pointeur vers une chaîne qui spécifie le nom du domaine Active Directory qui contient l’espace de noms DFS basé sur le domaine à supprimer. Ce paramètre est obligatoire.

[in] ServerName

Pointeur vers une chaîne qui spécifie le nom du serveur cible racine DFS à supprimer. Le serveur doit héberger une racine de l’espace de noms DFS basé sur le 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 le 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

Doit être 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

L’appelant doit avoir l’autorisation de mettre à jour le conteneur DFS dans le service d’annuaire et doit disposer du privilège Administrateur sur le serveur hôte DFS (racine).

La fonction NetDfsRemoveFtRootForced supprime de force une cible racine DFS basée sur un domaine d’un espace de noms DFS. Il est utilisé pour supprimer un espace de noms DFS basé sur un domaine lorsque les serveurs cibles racine de l’espace de noms ne sont plus disponibles (par exemple, parce qu’ils ont été mis hors service).

Étant donné que la cible racine DFS est supprimée en contactant le contrôleur de domaine principal (PDC) et non en supprimant le serveur cible racine DFS, NetDfsRemoveFtRootForced ne met pas à jour le registre du serveur cible racine. Dans des circonstances normales, vous pouvez supprimer la cible racine d’une racine de domaine DFS en appelant la fonction NetDfsRemoveFtRoot .

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

Voir aussi

Fonctions DFS (Distributed File System)

NetDfsAddFtRoot

NetDfsRemoveFtRoot

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau

Partager via