DFS_INFO_9 structure (lmdfs.h)
Contient le nom, le status, le GUID, le délai d’attente, les indicateurs de propriété, la taille des métadonnées, les informations de cible DFS, le descripteur de sécurité du point d’analyse de lien et une liste de cibles DFS pour une racine ou un lien. Cette structure est uniquement destinée aux fonctions NetDfsGetInfo et NetDfsEnum .
Syntaxe
typedef struct _DFS_INFO_9 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
ULONG PropertyFlags;
ULONG MetadataSize;
ULONG SecurityDescriptorLength;
#if ...
PUCHAR pSecurityDescriptor;
ULONG SdLengthReserved;
#else
PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
DWORD NumberOfStorages;
#if ...
LPDFS_STORAGE_INFO_1 Storage;
#else
LPDFS_STORAGE_INFO_1 Storage;
#endif
} DFS_INFO_9, *PDFS_INFO_9, *LPDFS_INFO_9;
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 de lien DFS de ce membre. 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 qui décrivent 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)
Étendue : racines de domaine, racines autonomes et liens. Si cet indicateur est défini à la racine DFS, il s’applique à tous les liens ; sinon, la valeur de cet indicateur est prise en compte pour chaque lien individuel.
Lorsque cet indicateur est défini, une réponse de référence DFS d’un serveur DFS pour une racine DFS ou un lien avec l’option « INSITE » activée contient uniquement les cibles qui se trouvent sur le même site que le client DFS qui demande la référence. Les cibles des deux classes de priorité globales sont toujours retournées, quel que soit l’emplacement de leur site.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
Étendue : espace de noms DFS entier pour un espace de noms DFS basé sur un domaine uniquement.
Par défaut, un serveur cible racine DFS interroge le PDS pour détecter les modifications apportées aux métadonnées DFS. Pour éviter une charge de serveur importante sur le contrôleur de domaine principal, l’extensibilité racine peut être activée pour l’espace de noms DFS. Si vous définissez cet indicateur, le serveur DFS interroge le contrôleur de domaine le plus proche au lieu du contrôleur de domaine principal pour les modifications de métadonnées DFS pour l’espace de noms commun. Notez toutefois que toutes les modifications apportées aux métadonnées doivent toujours se produire sur le contrôleur de domaine principal.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
Étendue : espace de noms DFS complet pour les espaces de noms DFS basés sur un domaine et autonomes.
Par défaut, les cibles retournées dans une réponse de référence d’un serveur DFS vers un client DFS pour une racine ou un lien DFS se composent de deux groupes : les cibles dans le même site que le client et les cibles en dehors du site.
Si le coût du site est activé pour Active Directory, la réponse peut avoir plus de deux groupes, chaque groupe contenant des cibles avec le même coût de site pour le client DFS spécifique demandant la référence. Les groupes sont classés en augmentant le coût du site. Pour plus d’informations sur la façon dont le coût du site est utilisé pour hiérarchiser les cibles, consultez Hiérarchisation des cibles de serveur DFS.
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
Étendue : racines DFS basées sur un domaine, racines DFS autonomes et liens DFS. Si cet indicateur est défini à la racine DFS, il s’applique à tous les liens ; sinon, la valeur de cet indicateur est prise en compte pour chaque lien individuel.
Lorsque cet indicateur est défini, la restauration automatique de la cible optimale est activée pour les clients DFS V4, ce qui leur permet de revenir à une cible optimale après le basculement vers une cible non optimale. Le paramètre de restauration automatique cible est fourni au client DFS dans une réponse de référence V4 par un serveur DFS.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
Étendue : racines et liens DFS autonomes uniquement.
La racine DFS est en cluster pour fournir une haute disponibilité pour le basculement du stockage. 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’annuaires (ABDE) est activée sur l’intégralité 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 fonctionnalité 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 sur la racine de l’espace de noms DFS, et non sur les cibles racines, les liens ou les cibles de liaison. 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 champ spécifie la taille des métadonnées stockées dans le Registre, y compris les noms de clé et les noms de valeur, en plus des éléments de données spécifiques qui leur sont associés.
Ce champ est valide uniquement pour les racines DFS.
SecurityDescriptorLength
pSecurityDescriptor
Pointeur vers une structure de SECURITY_DESCRIPTOR qui spécifie un descripteur de sécurité auto-relatif à associer au point d’analyse de la liaison DFS. Ce champ est valide uniquement pour les liens DFS.
SdLengthReserved
Ce membre est réservé à l’utilisation du système.
NumberOfStorages
Spécifie le nombre de cibles pour la racine ou le lien DFS. Ces cibles sont contenues dans le membre Stockage de cette structure.
Storage
Spécifie un tableau de structures DFS_STORAGE_INFO_1 qui contiennent les informations de cible DFS.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista avec SP1 |
| Serveur minimal pris en charge | Windows Server 2008 |
| En-tête | lmdfs.h (include LmDfs.h, Lm.h) |