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
Fonctions de système de fichiers distribués (DFS)