Fonction NetDfsGetClientInfo (lmdfs.h)
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
ou
\\ 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 gestionré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 |