(lmdfs.h) DFS_INFO_6 结构
包含有关分布式文件系统的信息 (DFS) 根或链接。 此结构包含名称、状态、 GUID、超时、命名空间/根/链接属性、元数据大小、目标数以及有关根或链接的每个目标的信息。 此结构仅用于 NetDfsEnum、 NetDfsGetClientInfo 和 NetDfsGetInfo 函数。
若要在没有目标信息的情况下获取有关 DFS 命名空间的信息，请改用 DFS_INFO_5 。
语法
typedef struct _DFS_INFO_6 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
ULONG PropertyFlags;
ULONG MetadataSize;
DWORD NumberOfStorages;
#if ...
LPDFS_STORAGE_INFO_1 Storage;
#else
LPDFS_STORAGE_INFO_1 Storage;
#endif
} DFS_INFO_6, *PDFS_INFO_6, *LPDFS_INFO_6;
成员
EntryPath
指向以 null 结尾的 Unicode 字符串的指针，该字符串指定 DFS 根或链接的通用命名约定 (UNC) 路径。
对于链接，字符串可以是两种形式之一。 第一种形式如下所示：
\\ServerName\DfsName\link_path
其中 ，ServerName 是托管独立 DFS 命名空间的根目标服务器的名称; DfsName 是 DFS 命名空间的名称; 和 link_path 是 DFS 链接。
第二种形式如下所示：
\\DomainName\DomDfsname\link_path
其中 ，DomainName 是托管基于域的 DFS 命名空间的域的名称; DomDfsname 是 DFS 命名空间的名称; 和 link_path 是 DFS 链接。
对于根，字符串可以是以下两种形式之一：
\\ServerName\DfsName
或
\\DomainName\DomDfsname
其中，名称的值与前面所述的值相同。
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 根或链接的超时（以秒为单位）。
Guid
指定 DFS 根或链接的 GUID 。
PropertyFlags
指定描述 DFS 命名空间、根或链接的特定属性的一组标志。
DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)
范围：域根、独立根和链接。 如果在 DFS 根目录中设置此标志，则它将应用于所有链接;否则，将为每个单独的链接考虑此标志的值。
设置此标志后，DFS 服务器对启用了“INSITE”选项的 DFS 根或链接的 DFS 引用响应仅包含与请求引荐的 DFS 客户端位于同一站点中的那些目标。 始终返回两个全局优先级类中的目标，无论其站点位置如何。
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
范围：仅限基于域的 DFS 命名空间的整个 DFS 命名空间。
默认情况下，DFS 根目标服务器轮询 PDS 以检测对 DFS 元数据的更改。 若要防止 PDC 上的服务器负载过大，可以为 DFS 命名空间启用根可伸缩性。 设置此标志将导致 DFS 服务器轮询最近的域控制器，而不是针对公共命名空间的 DFS 元数据更改的 PDC。 但请注意，对元数据所做的任何更改都必须仍发生在 PDC 上。
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
范围：基于域和独立 DFS 命名空间的整个 DFS 命名空间。
默认情况下，从 DFS 服务器到 DFS 根或链接的 DFS 客户端的引用响应中返回的目标由两组组成：与客户端位于同一站点中的目标和站点外部的目标。
如果为 Active Directory 启用了站点成本计算，则响应可以包含两个以上的组，每个组包含的目标与请求引荐的特定 DFS 客户端具有相同的站点成本。 这些组按增加站点成本进行排序。 有关如何使用站点成本计算来确定目标的优先级的详细信息，请参阅 DFS 服务器目标优先级。
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
范围：基于域的 DFS 根、独立 DFS 根和 DFS 链接。 如果在 DFS 根目录中设置此标志，则它将应用于所有链接;否则，将为每个单独的链接考虑此标志的值。
设置此标志后，会为 V4 DFS 客户端启用最佳目标故障回复，允许它们在故障转移到非最佳目标后故障回复到最佳目标。 目标故障回复设置由 DFS 服务器在 V4 引用响应中提供给 DFS 客户端。
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
范围：仅独立 DFS 根和链接。
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 链接相关联。
MetadataSize
对于基于域的 DFS 命名空间，此成员指定相应 Active Directory 数据 Blob 的大小（以字节为单位）。 对于独立的 DFS 命名空间，此字段指定存储在注册表中的元数据的大小，包括键名称和值名称以及与它们关联的特定数据项。
此字段仅对 DFS 根有效。
NumberOfStorages
指定 DFS 根或链接的目标数。 这些目标包含在此结构的 Storage 成员中。
Storage
指定包含 DFS 目标信息的 DFS_STORAGE_INFO_1 结构的数组。
注解
有关如何确定服务器目标优先级的详细信息，请参阅 DFS 服务器目标优先级。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008、Windows Server 2008 |
| 标头 | lmdfs.h (包括 LmDfs.h、Lm.h) |