DFS_INFO_105 结构 (lmdfs.h)

包含有关 DFS 根或链接的信息，包括由属性标志指定的注释、状态、超时和 DFS 行为。此结构仅用于 NetDfsSetInfo 函数。

语法

typedef struct _DFS_INFO_105 {
  LPWSTR Comment;
  DWORD  State;
  ULONG  Timeout;
  ULONG  PropertyFlagMask;
  ULONG  PropertyFlags;
} DFS_INFO_105, *PDFS_INFO_105, *LPDFS_INFO_105;

成员

Comment

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

State

指定描述 DFS 根或链接状态的一组位标志;无法更改 DFS 命名空间根的状态。设置一个 DFS_VOLUME_STATE 标志，设置一个 DFS_VOLUME_FLAVOR 标志。有关描述这些标志的解释的示例，请参阅 DFS_INFO_2 的“备注”部分。

默认 (0x00000000)

保留现有状态。

DFS_VOLUME_STATE_OK (0x00000001)

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

DFS_VOLUME_STATE_OFFLINE (0x00000003)

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

DFS_VOLUME_STATE_ONLINE (0x00000004)

指定的 DFS 根或链接可用。

Timeout

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

PropertyFlagMask

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

PropertyFlags

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

DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)

来自 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_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)

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

DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)

范围：仅独立根和链接。

如果设置了此标志，则会对 DFS 根目录进行群集，以便为存储故障转移提供高可用性。无法使用 NetDfsSetInfo 函数设置此标志。

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 链接相关联。

要求


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