NetDfsAddRootTarget, fonction (lmdfs.h)

Article
08/24/2023

Crée un espace de noms DFS autonome ou basé sur un domaine ou ajoute une nouvelle cible racine à un espace de noms basé sur un domaine existant.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetDfsAddRootTarget(
  [in]           LPWSTR pDfsPath,
  [in, optional] LPWSTR pTargetPath,
  [in]           ULONG  MajorVersion,
  [in, optional] LPWSTR pComment,
  [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 être au format suivant :

\\ Servername\DfsName

où ServerName est le nom du serveur qui hébergera la nouvelle 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 être au format suivant :

\\ 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 nouveau ou existant basé sur un domaine. Pour des raisons de compatibilité, DomDfsName doit être identique au nom du dossier partagé sur le serveur qui hébergera la nouvelle cible racine 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 être au format suivant :

\\ Servername\RootShare

où ServerName est le nom du serveur qui hébergera la nouvelle cible racine DFS et RootShare est le nom du dossier partagé sur le serveur. Le partage spécifié par RootShare doit déjà exister sur le serveur qui hébergera la nouvelle cible racine DFS. Cette fonction ne crée pas de partage.

[in] MajorVersion

Spécifie la version des métadonnées DFS pour l’espace de noms.

Note Ce paramètre est uniquement destiné à être utilisé lors de la création d’un espace de noms.

Si un espace de noms DFS autonome est en cours de création, ce paramètre doit avoir la valeur 1.

Si un espace de noms basé sur un domaine est créé, ce paramètre doit être défini comme suit :

Définissez-le sur 1 pour spécifier le mode Windows 2000.
Définissez-la sur 2 ou une version ultérieure pour spécifier le mode Windows Server 2008.

Si une nouvelle cible racine est ajoutée à un espace de noms DFS basé sur un domaine existant, ce paramètre doit être défini sur zéro.

[in, optional] pComment

Pointeur vers une chaîne Unicode terminée par null qui contient un commentaire associé à la racine 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 le domaine n’est pas au niveau fonctionnel requis pour la MajorVersion spécifiée, la valeur de retour est ERROR_DS_INCOMPATIBLE. Cette valeur de retour s’applique uniquement aux racines de domaine et à une MajorVersion de 2.

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 du privilège Administrateur sur le serveur DFS.

Pour déterminer la version des métadonnées DFS qui peut être spécifiée dans le paramètre MajorVersion , utilisez la fonction NetDfsGetSupportedNamespaceVersion .

Le tableau suivant indique les valeurs de paramètre que vous devez spécifier, en fonction du résultat souhaité.

Paramètre pDfsPath	Paramètre pTargetPath	Paramètre MajorVersion	Résultats
\\DomainName\DomDfsName	\\ServerName\RootShare	1	Créez un espace de noms DFS basé sur un domaine en mode Windows 2000 ou ajoutez une nouvelle cible racine à une cible existante.
\\DomainName\DomDfsName	\\ServerName\RootShare	2	Créez un espace de noms DFS basé sur un domaine en mode Windows Server 2008 ou ajoutez une nouvelle cible racine à une cible existante.
\\DomainName\DomDfsName	\\ServerName\RootShare	0	Ajoutez une nouvelle cible racine à un espace de noms DFS basé sur un domaine en mode Windows 2000 ou windows Server 2008.
\\ServerName\DfsName	NULL	Doit être égal à 1.	Créez 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