(lmdfs.h) DFS_INFO_5 结构

项目
08/24/2023

包含有关分布式文件系统 (DFS) 根或链接的信息。此结构包含名称、状态、 GUID、超时、命名空间/根/链接属性、元数据大小以及根或链接的目标数。此结构仅适用于 NetDfsEnum、 NetDfsGetClientInfo 和 NetDfsGetInfo 函数。

若要检索有关 DFS 命名空间目标的信息，请改用 DFS_INFO_6 。

语法

typedef struct _DFS_INFO_5 {
  LPWSTR EntryPath;
  LPWSTR Comment;
  DWORD  State;
  ULONG  Timeout;
  GUID   Guid;
  ULONG  PropertyFlags;
  ULONG  MetadataSize;
  DWORD  NumberOfStorages;
} DFS_INFO_5, *PDFS_INFO_5, *LPDFS_INFO_5;

成员

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_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_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)

轮询最近的域控制器，而不是 DFS 命名空间更改的 PDC。此标志仅对域根有效。

DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)

已启用目标的 Active Directory 站点成本计算，将目标分组为从 DFS 客户端到目标增加的站点成本集。每个集都有具有相同成本的目标。此标志仅适用于域和独立根。

DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)

故障转移到非最佳目标后，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 链接相关联。

MetadataSize

对于基于域的 DFS 命名空间，此成员指定相应的 Active Directory 数据 Blob 的大小（以字节为单位）。对于独立的 DFS 命名空间，此成员指定存储在注册表中的元数据的大小，包括键名称和值名称以及与它们关联的特定数据项。

此成员仅对 DFS 根有效。

NumberOfStorages

指定 DFS 根或链接的目标数。

注解

若要检索有关目标和目标优先级的信息，请使用 DFS_INFO_6 结构。 DFS_INFO_5 用于指定有关没有目标信息的 DFS 命名空间的信息。

要求


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