(lmdfs.h) DFS_INFO_5 结构

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

若要检索有关 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_50DFS_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)

另请参阅

DFS_INFO_6

分布式文件系统 (DFS) 函数

NetDfsEnum

NetDfsGetInfo

网络管理概述

网络管理结构