Fonction NetDfsSetClientInfo (lmdfs.h)
Modifie les informations sur une racine ou un lien de système de fichiers distribué (DFS) dans le cache géré par le client DFS.
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetDfsSetClientInfo(
[in] LPWSTR DfsEntryPath,
[in, optional] LPWSTR ServerName,
[in, optional] LPWSTR ShareName,
[in] DWORD Level,
[in] 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
or
\\ 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 de liaison DFS. Ce paramètre est facultatif. Pour plus d'informations, consultez la section Notes.
[in, optional] ShareName
Pointeur vers une chaîne qui spécifie le nom de partage cible du lien DFS. Ce paramètre est facultatif. Pour plus d’informations, consultez la section Remarques suivante.
[in] Level
Spécifie le niveau d’informations de la demande. Ce paramètre peut prendre les valeurs suivantes.
101
Définissez le status de stockage du lien DFS local. Le paramètre Buffer pointe vers une structure DFS_INFO_101 .
102
Définissez le délai d’expiration du lien DFS local. Le paramètre Buffer pointe vers une structure DFS_INFO_102 . Pour plus d'informations, consultez la section Notes qui suit.
[in] Buffer
Pointeur vers une mémoire tampon qui contient les informations à définir. Le format de ces informations dépend de la valeur du paramètre Level . Pour plus d’informations, consultez Mémoires tampons de fonction 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.
Notes
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.
La définition du délai d’attente sur zéro peut ne pas supprimer immédiatement la copie mise en cache locale du lien DFS, car les threads peuvent référencer l’entrée.
Étant donné qu’il n’existe qu’un seul délai d’attente sur un lien DFS, les paramètres ServerName et ShareName sont ignorés pour le niveau 102.
Les bits DFS_STORAGE_STATE_ONLINE et DFS_STORAGE_STATE_OFFLINE sont ignorés. Le bit DFS_STORAGE_STATE_ACTIVE est valide uniquement si aucun fichier n’est ouvert sur l’ordinateur actif.
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 |