NetDfsAddFtRoot, fonction (lmdfs.h)
Crée un espace de noms DFS (Distributed File System) basé sur un domaine. Si l’espace de noms existe déjà, la fonction lui ajoute la cible racine spécifiée.
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetDfsAddFtRoot(
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[in] LPWSTR FtDfsName,
[in, optional] LPWSTR Comment,
[in] DWORD Flags
);
Paramètres
[in] ServerName
Pointeur vers une chaîne qui spécifie le nom du serveur qui hébergera la nouvelle cible racine DFS. Cette valeur ne peut pas être une adresse IP. Ce paramètre est obligatoire.
[in] RootShare
Pointeur vers une chaîne qui spécifie le nom du dossier partagé sur le serveur qui hébergera la nouvelle cible racine DFS. Ce paramètre est obligatoire.
[in] FtDfsName
Pointeur vers une chaîne qui spécifie le nom de l’espace de noms DFS nouveau ou existant basé sur un domaine. Ce paramètre est obligatoire. Pour des raisons de compatibilité, il doit spécifier la même chaîne que le paramètre RootShare .
[in, optional] Comment
Pointeur vers une chaîne qui contient un commentaire facultatif associé à l’espace de noms DFS.
[in] 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.
Notes
Le partage spécifié par le paramètre RootShare doit déjà exister sur le serveur qui hébergera la nouvelle cible racine DFS. Cette fonction ne crée pas de partage.
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
| 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 |