NetDfsSetInfo, fonction (lmdfs.h)
Définit ou modifie des informations sur une racine, une cible racine, un lien ou une cible de lien spécifique du système de fichiers distribué (DFS).
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetDfsSetInfo(
[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.
[in, optional] ServerName
Pointeur vers une chaîne qui spécifie le nom du serveur cible du lien 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. Il peut également s’agir d’un nom de partage avec un chemin relatif au partage. Par exemple, « share1\mydir1\mydir2 ». Ce paramètre est facultatif. Pour plus d'informations, consultez la section Notes.
[in] Level
Spécifie le niveau d’informations des données. Ce paramètre peut prendre les valeurs suivantes.
100
Définissez le commentaire associé à la racine ou au lien DFS spécifié dans le paramètre DfsEntryPath . Le paramètre Buffer pointe vers une structure DFS_INFO_100 .
101
Définissez l’état de stockage associé à la racine ou au lien DFS spécifié dans le paramètre DfsEntryPath . Le paramètre Buffer pointe vers une structure DFS_INFO_101 .
102
Définissez la valeur de délai d’attente associée à la racine ou au lien DFS spécifié dans le paramètre DfsEntryPath . Le paramètre Buffer pointe vers une structure DFS_INFO_102 .
103
Définissez les indicateurs de propriété pour la racine ou le lien DFS spécifié dans le paramètre DfsEntryPath . Le paramètre Buffer pointe vers une structure DFS_INFO_103 .
104
Définissez le rang et la classe de priorité cible pour la cible racine ou la cible de liaison spécifiée dans le paramètre DfsEntryPath . Le paramètre Buffer pointe vers une structure DFS_INFO_104 .
105
Définissez les informations de commentaire, d’état et de délai d’attente, ainsi que les indicateurs de propriété, pour la racine ou le lien DFS spécifié dans le paramètre DfsEntryPath . Le paramètre Buffer pointe vers une structure DFS_INFO_105 .
106
Définissez l’état et la priorité de la cible racine ou de la cible de liaison spécifiée dans le paramètre DfsEntryPath . Ces informations ne peuvent pas être définies pour une racine ou un lien d’espace de noms DFS, uniquement pour une cible racine ou une cible de lien. Le paramètre Buffer pointe vers une structure DFS_INFO_106 .
107
Définissez le commentaire, l’état, les informations de délai d’attente et les indicateurs de propriété pour la racine ou le lien DFS spécifiés dans le paramètre DfsEntryPath . Pour les liens DFS, vous pouvez également définir le descripteur de sécurité pour le point d’analyse du lien. Le paramètre Buffer pointe vers une structure DFS_INFO_107 .
150
Définissez le descripteur de sécurité pour le point d’analyse d’une liaison DFS. Le paramètre Buffer pointe vers une structure DFS_INFO_150 .
[in] Buffer
Pointeur vers une mémoire tampon qui spécifie les données. Le format de ces données 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.
Si vous spécifiez les paramètres ServerName et ShareName , la fonction NetDfsSetInfo définit ou modifie les informations spécifiques à cette cible racine ou cible de lien. Si les paramètres ont la valeur NULL, la fonction définit ou modifie des informations spécifiques à la racine de l’espace de noms DFS ou au lien DFS au lieu d’une cible racine ou d’une cible de lien DFS spécifique.
Étant donné qu’un seul commentaire et un seul délai d’attente peuvent être définis pour une racine ou un lien DFS, les paramètres ServerName et ShareName sont ignorés pour les niveaux d’informations 100 et 102. Ces paramètres sont requis pour le niveau 101.
Pour le niveau d’informations 101, les valeurs d’état DFS_VOLUME_STATE_RESYNCHRONIZE et DFS_VOLUME_STATE_STANDBY peuvent être définies comme suit pour une racine DFS basée sur un domaine spécifique lorsqu’il existe plusieurs cibles racines DFS pour l’espace de noms DFS :
Le paramètre DfsEntryPath spécifie l’espace de noms DFS basé sur le domaine, et les paramètres ServerName et ShareName , pris ensemble, spécifient la cible racine DFS sur laquelle l’opération set-information doit être effectuée.
Exemples
L’exemple de code suivant montre comment associer un commentaire à un lien DFS à l’aide d’un appel à la fonction NetDfsSetInfo . L’exemple spécifie le niveau d’informations 100 (DFS_INFO_100).
#include <windows.h>
#include <lm.h>
#include <lmdfs.h>
#include <stdio.h>
#pragma comment(lib, "Netapi32.lib")
void wmain(int argc, wchar_t *argv[])
{
DFS_INFO_100 dfsData;
DWORD res;
//
// Check command line arguments.
//
if (argc<2)
wprintf(L"Syntax: %s DfsEntryPath [\"Comment\"]\n", argv[0]);
else
{
//
// Fill in DFS_INFO_100 structure member.
//
dfsData.Comment = argc < 3 ? NULL : argv[2];
//
// Call the NetDfsSetInfo function, specifying level 100.
//
res = NetDfsSetInfo(argv[1], NULL, NULL, 100, (LPBYTE) &dfsData);
//
// Display the result of the call.
//
if(res == 0)
printf("Comment set.\n");
else
printf("Error: %u", res);
}
return;
}
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 |