structure DFS_INFO_5 (lmdfs.h)

Article
08/24/2023

Contient des informations sur un lien ou une racine de système de fichiers distribué (DFS). Cette structure contient le nom, la status, le GUID, le délai d’expiration, les propriétés d’espace de noms/racine/lien, la taille des métadonnées et le nombre de cibles pour la racine ou le lien. Cette structure est uniquement à utiliser avec les fonctions NetDfsEnum, NetDfsGetClientInfo et NetDfsGetInfo .

Pour récupérer des informations sur les cibles de l’espace de noms DFS, utilisez DFS_INFO_6 à la place.

Syntaxe

typedef struct _DFS_INFO_5 {
  LPWSTR EntryPath;
  LPWSTR Comment;
  DWORD  State;
  ULONG  Timeout;
  GUID   Guid;
  ULONG  PropertyFlags;
  ULONG  MetadataSize;
  DWORD  NumberOfStorages;
} DFS_INFO_5, *PDFS_INFO_5, *LPDFS_INFO_5;

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

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

PropertyFlags

Spécifie un ensemble d’indicateurs décrivant des propriétés spécifiques d’un espace de noms, d’une racine ou d’un lien DFS.

DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)

Seules les cibles du même site que le client sont retournées. Cet indicateur est valide à la fois pour les racines et les liens autonomes et de domaine.

DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)

Le contrôleur de domaine le plus proche est interrogé à la place du contrôleur de domaine pour les modifications de l’espace de noms DFS. Cet indicateur n’est valide que pour les racines de domaine.

DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)

Le coût des cibles du site Active Directory est activé, ce qui regroupe les cibles en ensembles de coûts de site croissants du client DFS à la cible. Chaque ensemble a des objectifs avec le même coût. Cet indicateur est valide uniquement pour les racines de domaine et autonomes.

DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)

Le client DFS revient à une cible disponible plus proche après le basculement vers une cible non optimale. Cet indicateur est valide à la fois pour les racines et les liens autonomes et de domaine.

DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)

La racine DFS est en cluster. Cet indicateur ne peut pas être défini à l’aide de la fonction NetDfsSetInfo .

DFS_PROPERTY_FLAG_ABDE (0x00000020)

Étendue : racines DFS basées sur un domaine et racines DFS autonomes.

Lorsque cet indicateur est défini, Access-Based prise en charge du mode d’énumération d’annuaire (ABDE) est activée sur l’ensemble du partage cible racine DFS de l’espace de noms DFS. Cet indicateur est valide uniquement pour les espaces de noms DFS pour lesquels l’indicateur de capacité DFS_NAMESPACE_CAPABILITY_ABDE est défini. Pour plus d’informations, consultez DFS_INFO_50 et DFS_SUPPORTED_NAMESPACE_VERSION_INFO.

L’indicateur DFS_PROPERTY_FLAG_ABDE est valide uniquement à la racine de l’espace de noms DFS et non sur les cibles racines, les liens ou les cibles de lien. Cet indicateur doit être activé pour associer un descripteur de sécurité à un lien DFS.

MetadataSize

Pour les espaces de noms DFS basés sur un domaine, ce membre spécifie la taille de l’objet blob de données Active Directory correspondant, en octets. Pour les espaces de noms DFS autonomes, ce membre spécifie la taille des métadonnées stockées dans le Registre, y compris les noms de clés et de valeurs, ainsi que les éléments de données spécifiques qui leur sont associés.

Ce membre est valide uniquement pour les racines DFS.

NumberOfStorages

Spécifie le nombre de cibles pour la racine ou le lien DFS.

Notes

Pour récupérer des informations sur les cibles et les priorités cibles, utilisez la structure DFS_INFO_6 . DFS_INFO_5 est utilisé pour spécifier des informations sur un espace de noms DFS sans informations cibles.

Configuration requise


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