NetDfsAddStdRoot, fonction (lmdfs.h)
Crée un espace de noms DFS (Distributed File System) autonome.
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetDfsAddStdRoot(
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[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 le nouvel espace de noms DFS autonome. Ce paramètre est obligatoire.
[in] RootShare
Pointeur vers une chaîne qui spécifie le nom du dossier partagé pour le nouvel espace de noms DFS autonome sur le serveur qui hébergera l’espace de noms. Ce paramètre est obligatoire.
[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.
Remarques
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 disposer du privilège Administrateur sur le serveur DFS. Pour plus d’informations sur l’appel de fonctions qui nécessitent des privilèges d’administrateur, consultez Exécution avec des privilèges spéciaux.
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 |