NetDfsSetInfo, fonction (lmdfs.h)

Article
08/24/2023

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

\\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