Fonction NetDfsGetClientInfo (lmdfs.h)

Article
02/28/2024

Récupère des informations sur une racine ou un lien de système de fichiers distribué (DFS) à partir du cache géré par le client DFS.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetDfsGetClientInfo(
  [in]           LPWSTR DfsEntryPath,
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR ShareName,
  [in]           DWORD  Level,
  [out]          LPBYTE *Buffer
);

Paramètres

[in] DfsEntryPath

Pointeur vers une chaîne qui spécifie le chemin d’accès UNC (Universal Naming Convention) d’une racine ou d’un lien DFS.

Pour un lien, la chaîne peut être sous l’une des deux formes suivantes. Le premier formulaire est le suivant :

\\Servername\DfsName\link_path

où ServerName est le nom du serveur cible racine qui héberge l’espace de noms DFS autonome ; DfsName est le nom de l’espace de noms DFS ; et link_path est un lien DFS.

Le deuxième formulaire est le suivant :

\\Domainname\DomDfsname\link_path

où DomainName est le nom du domaine qui héberge l’espace de noms DFS basé sur le domaine ; DomDfsname est le nom de l’espace de noms DFS ; et link_path est un lien DFS.

Pour une racine, la chaîne peut être sous l’une des deux formes suivantes :

\\Servername\DfsName

\\Domainname\DomDfsname

où les valeurs des noms sont les mêmes que celles décrites précédemment.

Ce paramètre est obligatoire.

[in, optional] ServerName

Pointeur vers une chaîne qui spécifie le nom du serveur cible racine ou du serveur cible de liaison DFS. Ce paramètre est facultatif.

[in, optional] ShareName

Pointeur vers une chaîne qui spécifie le nom du partage correspondant à la cible racine ou à la cible de liaison DFS. Ce paramètre est facultatif.

[in] Level

Spécifie le niveau d’informations de la demande. Ce paramètre peut prendre les valeurs suivantes.

1

Retourne la racine DFS ou le nom du lien DFS. Le paramètre Buffer pointe vers une structure DFS_INFO_1 .

2

Retourne le nom de lien DFS ou DFS, status et le nombre de cibles DFS. Le paramètre Buffer pointe vers une structure DFS_INFO_2 .

3

Retournez le nom, le status et la cible du lien DFS ou le nom du lien DFS. Le paramètre Buffer pointe vers une structure DFS_INFO_3 .

4

Retournez le nom du lien DFS ou DFS, status, GUID, délai d’attente et les informations cibles. Le paramètre Buffer pointe vers une structure DFS_INFO_4 .

[out] Buffer

Pointeur vers l’adresse d’une mémoire tampon qui reçoit les informations demandées. Cette mémoire tampon est allouée par le système et doit être libérée à l’aide de la fonction NetApiBufferFree . Pour plus d’informations, consultez Mémoires tampons de fonction de gestion réseau et Longueurs de mémoire tampon des fonctions de gestion réseau.

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

Aucune appartenance à un groupe spécial n’est requise pour utiliser la fonction NetDfsGetClientInfo .

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