(lmdfs.h) DFS_INFO_6 结构

项目
08/24/2023

包含有关分布式文件系统的信息 (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)