DFS_INFO_4 structure (lmdfs.h)

Contient des informations sur une racine ou un lien du système de fichiers distribués (DFS). Cette structure contient le nom, le status, le GUID, le délai d’attente, le nombre de cibles et des informations sur chaque cible de la racine ou du lien. Cette structure est uniquement destinée à être utilisée avec les fonctions NetDfsEnum, NetDfsGetClientInfo et NetDfsGetInfo , ainsi qu’avec le code de contrôle FSCTL_DFS_GET_PKT_ENTRY_STATE .

Syntaxe

typedef struct _DFS_INFO_4 {
  LPWSTR             EntryPath;
  LPWSTR             Comment;
  DWORD              State;
  ULONG              Timeout;
  GUID               Guid;
  DWORD              NumberOfStorages;
#if ...
  LPDFS_STORAGE_INFO Storage;
#else
  LPDFS_STORAGE_INFO Storage;
#endif
} DFS_INFO_4, *PDFS_INFO_4, *LPDFS_INFO_4;

Membres

EntryPath

Pointeur vers une chaîne Unicode terminée par null 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.

Comment

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient un commentaire associé à la racine ou au lien DFS.

State

Spécifie un ensemble d’indicateurs de bits qui décrivent la racine ou le lien DFS. Un indicateur DFS_VOLUME_STATE est défini et un indicateur DFS_VOLUME_FLAVOR est défini. Le masque de bits DFS_VOLUME_FLAVORS (0x00000300) doit être utilisé pour extraire la saveur de l’espace de noms DFS, et le masque de bits DFS_VOLUME_STATES (0x0000000F) doit être utilisé pour extraire l’état racine ou lien DFS de ce champ. Pour obtenir un exemple qui décrit l’interprétation des indicateurs, consultez la section Remarques de DFS_INFO_2.

DFS_VOLUME_STATE_OK (0x00000001)

La racine ou le lien DFS spécifié est dans l’état normal.

DFS_VOLUME_STATE_INCONSISTENT (0x00000002)

La base de données DFS interne n’est pas cohérente avec la racine ou le lien DFS spécifié. Les tentatives de réparation de l’incohérence ont échoué.

DFS_VOLUME_STATE_OFFLINE (0x00000003)

La racine ou le lien DFS spécifié est hors connexion ou indisponible.

DFS_VOLUME_STATE_ONLINE (0x00000004)

La racine ou le lien DFS spécifié est disponible.

DFS_VOLUME_FLAVOR_STANDALONE (0x00000100)

Le système définit cet indicateur si la racine est associée à un espace de noms DFS autonome.

DFS_VOLUME_FLAVOR_AD_BLOB (0x00000200)

Le système définit cet indicateur si la racine est associée à un espace de noms DFS basé sur un domaine.

Timeout

Spécifie le délai d’attente, en secondes, de la racine ou du lien DFS.

Guid

Spécifie le GUID de la racine ou du lien DFS.

NumberOfStorages

Spécifie le nombre de cibles DFS.

Storage

Pointeur vers un tableau de structures DFS_STORAGE_INFO . Le membre NumberOfStorages spécifie le nombre de structures dans le tableau.

Remarques

Une structure DFS_INFO_4 contient une ou plusieurs structures DFS_STORAGE_INFO , une pour chaque cible DFS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	lmdfs.h (include LmDfs.h, Lm.h)

Voir aussi

DFS_STORAGE_INFO

Fonctions de système de fichiers distribués (DFS)

NetDfsEnum

NetDfsGetClientInfo

NetDfsGetInfo

Vue d’ensemble de la gestion du réseau

Structures de gestion réseau