DFS_INFO_8 结构 (lmdfs.h)
包含根或链接的名称、状态、 GUID、超时、属性标志、元数据大小、DFS 目标信息和链接重新分析点安全描述符。 此结构仅用于 NetDfsGetInfo 和 NetDfsEnum 函数。
语法
typedef struct _DFS_INFO_8 {
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;
} DFS_INFO_8, *PDFS_INFO_8, *LPDFS_INFO_8;
成员
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 服务器轮询最近的域控制器，而不是 PDC，以轮询公共命名空间的 DFS 元数据更改。 请注意，对元数据所做的任何更改仍必须在 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 根有效。
SecurityDescriptorLength
pSecurityDescriptor
指向 SECURITY_DESCRIPTOR 结构的指针，该结构指定要与 DFS 链接的重分析点关联的自相对安全描述符。 此字段仅对 DFS 链接有效。
SdLengthReserved
此成员保留供系统使用。
NumberOfStorages
指定包含 DFS 根或链接的卷的存储服务器数。
要求
| 最低受支持的客户端 | Windows Vista SP1 |
| 最低受支持的服务器 | Windows Server 2008 |
| 标头 | lmdfs.h (包括 LmDfs.h、Lm.h) |