DFS_INFO_2 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, la status et le nombre de cibles DFS pour la racine ou le 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_2 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
DWORD NumberOfStorages;
} DFS_INFO_2, *PDFS_INFO_2, *LPDFS_INFO_2;
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
or
\\ 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 de lien DFS de ce membre. Pour obtenir un exemple qui décrit l’interprétation des indicateurs, consultez la section Notes suivante.
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.
NumberOfStorages
Spécifie le nombre de cibles DFS.
Notes
Les fonctions DFS utilisent la structure DFS_INFO_2 pour récupérer des informations sur une racine ou un lien DFS.
Voici un exemple qui décrit l’interprétation des indicateurs qui peuvent être retournés dans le membre de l’État :
FlavorBits = (Flags & DFS_VOLUME_FLAVORS)
If (FlavorBits == DFS_VOLUME_FLAVOR_STANDALONE) // namespace is stand-alone DFS
else if (FlavorBits == DFS_VOLUME_FLAVOR_AD_BLOB) // namespace is AD blob
else // unknown flavor
StateBits = (Flags & DFS_VOLUME_STATES)
// StateBits can be one of the following:
// (DFS_VOLUME_STATE_OK, DFS_VOLUME_STATE_INCONSISTENT,
// DFS_VOLUME_STATE_OFFLINE or DFS_VOLUME_STATE_ONLINE)
Configuration requise
| 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)