(lmdfs.h) DFS_INFO_107 结构

项目
08/24/2023

包含有关 DFS 根或链接的信息，包括注释、状态、超时、属性标志和链接重分析点安全描述符。此结构仅用于 NetDfsGetInfo 和 NetDfsSetInfo 函数。

语法

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;

成员

Comment

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含与 DFS 根或链接关联的注释。

State

指定一组描述 DFS 根或链接的位标志。设置一个 DFS_VOLUME_STATE 标志，设置一个 DFS_VOLUME_FLAVOR 标志。 必须使用DFS_VOLUME_FLAVORS位掩码 (0x00000300) 提取 DFS 命名空间风格，并且必须使用DFS_VOLUME_STATES位掩码 (0x0000000F) 从此成员中提取 DFS 根或链接状态。有关描述标志解释的示例，请参阅 DFS_INFO_2 的“备注”部分。

DFS_VOLUME_STATE_OK (0x00000001)

指定的 DFS 根或链接处于正常状态。

DFS_VOLUME_STATE_INCONSISTENT (0x00000002)

内部 DFS 数据库与指定的 DFS 根或链接不一致。尝试修复不一致失败。

DFS_VOLUME_STATE_OFFLINE (0x00000003)

指定的 DFS 根目录或链接处于脱机状态或不可用。

DFS_VOLUME_STATE_ONLINE (0x00000004)

指定的 DFS 根或链接可用。

DFS_VOLUME_FLAVOR_STANDALONE (0x00000100)

如果根与独立的 DFS 命名空间相关联，则系统会设置此标志。

DFS_VOLUME_FLAVOR_AD_BLOB (0x00000200)

如果根与基于域的 DFS 命名空间关联，则系统会设置此标志。

Timeout

指定 DFS 根或链接的超时（以秒为单位）。

PropertyFlagMask

指定一个掩码值，该值指示哪些标志对 PropertyFlags 字段中的计算有效。

PropertyFlags

位域，每个位负责适用于整个 DFS 命名空间、DFS 根或单个 DFS 链接的特定属性，具体取决于实际属性。除非另有说明，否则允许位的任意组合。

DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)

来自 DFS 服务器的引荐响应，该 DFS 根或链接仅包含请求引荐的客户端位于同一站点中的这些目标。始终返回两个全局优先级类中的目标，无论其站点位置如何。此标志适用于基于域的 DFS 根、独立 DFS 根和 DFS 链接。如果在 DFS 根目录中设置此标志，则它将应用于所有链接;否则，它将应用于单个链接。链接处的设置不会替代根设置。

DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)

如果设置了此标志，DFS 服务器将轮询最近的域控制器 (DC) ，而不是主域控制器， (PDC) 检查该命名空间的 DFS 命名空间更改。 DFS 服务器对 DFS 元数据所做的任何修改不受此标志控制，但会发送到 PDC。此标志对整个命名空间有效，仅适用于基于域的 DFS 命名空间。

DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)

设置此标志以启用目标 Active Directory 站点成本计算。从 DFS 服务器返回到请求 DFS 客户端的目标按 DFS 客户端的站点间成本进行分组。这些组按增加站点成本进行排序，第一组由与客户端位于同一站点中的目标组成。每个组中的目标是随机排序的。

如果未启用此标志，则默认返回两个集：一组目标与客户端位于同一站点中，以及一组所有剩余目标。此标志对整个 DFS 命名空间有效，适用于基于域的 DFS 命名空间和独立 DFS 命名空间。

目标优先级可以进一步影响目标排序。有关如何使用站点成本计算来确定目标的优先级的详细信息，请参阅 DFS 服务器目标优先级。

DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)

设置此标志以使 V4 DFS 客户端能够故障回复到更优 (成本更低或优先级更高的目标) 。如果在 DFS 根目录中设置此标志，则它将应用于所有链接;否则，它将应用于单个链接。单个链接设置不会覆盖根设置。目标故障回复设置由 DFS 服务器在 V4 引用响应中提供给 DFS 客户端。此标志适用于基于域的根、独立根和链接。

DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)

如果设置了此标志，则会将 DFS 根群集化，以便为存储故障转移提供高可用性。此标志不能使用 NetDfsSetInfo 函数设置，并且仅适用于独立的 DFS 根和链接。

DFS_PROPERTY_FLAG_ABDE (0x00000020)

范围：基于域的 DFS 根和独立的 DFS 根。

设置此标志后，Access-Based 目录枚举 (DFS 命名空间的整个 DFS 根目标共享上启用 ABDE) 模式支持。此标志仅对设置了 DFS_NAMESPACE_CAPABILITY_ABDE 功能标志的 DFS 命名空间有效。有关详细信息，请参阅 DFS_INFO_50 和 DFS_SUPPORTED_NAMESPACE_VERSION_INFO。

DFS_PROPERTY_FLAG_ABDE标志仅在 DFS 命名空间根上有效，对根目标、链接或链接目标无效。必须启用此标志才能将安全描述符与 DFS 链接相关联。

SecurityDescriptorLength

pSecurityDescriptor

指向 SECURITY_DESCRIPTOR 结构的指针，该结构指定要与 DFS 链接的重分析点关联的自相对安全描述符。此字段仅对 DFS 链接有效。

SdLengthReserved

此成员保留供系统使用。

要求

要求	值
最低受支持的客户端	Windows Vista SP1
最低受支持的服务器	Windows Server 2008
标头	lmdfs.h (包括 LmDfs.h、Lm.h)

另请参阅

分布式文件系统函数

NetDfsSetInfo

通过