structure DFS_INFO_107 (lmdfs.h)
Contient des informations sur une racine ou un lien DFS, notamment le commentaire, l’état, le délai d’expiration, les indicateurs de propriété et le descripteur de sécurité de point d’analyse de lien. Cette structure est uniquement à utiliser avec les fonctions NetDfsGetInfo et NetDfsSetInfo .
Syntaxe
typedef struct _DFS_INFO_107 {
LPWSTR Comment;
DWORD State;
ULONG Timeout;
ULONG PropertyFlagMask;
ULONG PropertyFlags;
ULONG SecurityDescriptorLength;
#if ...
PUCHAR pSecurityDescriptor;
ULONG SdLengthReserved;
#else
PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
} DFS_INFO_107, *PDFS_INFO_107, *LPDFS_INFO_107;
Membres
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. 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.
PropertyFlagMask
Spécifie une valeur de masque qui indique quels indicateurs sont valides pour l’évaluation dans le champ PropertyFlags .
PropertyFlags
Bitfield, chaque bit étant responsable d’une propriété spécifique applicable à l’ensemble de l’espace de noms DFS, à la racine DFS ou à un lien DFS individuel, en fonction de la propriété réelle. Toute combinaison de bits est autorisée, sauf indication contraire.
DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)
Réponse de référence d’un serveur DFS pour une racine ou un lien DFS qui contient uniquement les cibles dans le même site que le client qui demande la référence. Les cibles des deux classes de priorité globale sont toujours retournées, quel que soit leur emplacement de site. Cet indicateur s’applique aux racines DFS basées sur un domaine, aux racines DFS autonomes et aux liens DFS. Si cet indicateur est défini à la racine DFS, il s’applique à tous les liens ; dans le cas contraire, elle s’applique à un lien individuel. Le paramètre au niveau du lien ne remplace pas le paramètre racine.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
Si cet indicateur est défini, le serveur DFS interroge le contrôleur de domaine (DC) le plus proche au lieu du contrôleur de domaine principal (PDC) pour case activée pour les modifications apportées à l’espace de noms DFS pour cet espace de noms. Toute modification apportée aux métadonnées DFS par le serveur DFS n’est pas contrôlée par cet indicateur, mais est envoyée au contrôleur de domaine. Cet indicateur est valide pour l’ensemble de l’espace de noms et s’applique uniquement aux espaces de noms DFS basés sur un domaine.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
Définissez cet indicateur pour activer le calcul des coûts de site Active Directory des cibles. Les cibles retournées du serveur DFS au client DFS demandeur sont regroupées par coût intersite par rapport au client DFS. Les groupes sont classés en termes d’augmentation du coût du site avec le premier groupe composé de cibles dans le même site que le client. Les cibles au sein de chaque groupe sont triées de manière aléatoire.
Si cet indicateur n’est pas activé, le retour par défaut est de deux ensembles : un ensemble de cibles dans le même site que le client et un ensemble de toutes les cibles restantes. Cet indicateur est valide pour l’ensemble de l’espace de noms DFS et s’applique aux espaces de noms DFS basés sur un domaine et autonomes.
Les priorités cibles peuvent influencer davantage l’ordre des cibles. 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 du serveur DFS.
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
Définissez cet indicateur pour permettre aux clients DFS V4 de revenir à une cible plus optimale (coût inférieur ou priorité plus élevée). Si cet indicateur est défini à la racine DFS, il s’applique à tous les liens ; dans le cas contraire, elle s’applique à un lien individuel. Un paramètre de lien individuel ne remplace pas un paramètre racine. Le paramètre de restauration automatique cible est fourni au client DFS dans une réponse de référence V4 par le serveur DFS. Cet indicateur s’applique aux racines basées sur un domaine, aux racines autonomes et aux liens.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
Si cet indicateur est défini, 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 et s’applique uniquement aux racines et liens DFS autonomes.
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.
SecurityDescriptorLength
pSecurityDescriptor
Pointeur vers une structure de SECURITY_DESCRIPTOR qui spécifie un descripteur de sécurité auto-relatif à associer au point d’analyse du lien DFS. Ce champ est valide uniquement pour les liens DFS.
SdLengthReserved
Ce membre est réservé à l’utilisation du système.
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) |