DFS_INFO_4 结构 (lmdfs.h)
包含有关分布式文件系统的信息 (DFS) 根或链接。 此结构包含名称、状态、 GUID、超时、目标数以及有关根或链接的每个目标的信息。 此结构仅用于 NetDfsEnum、 NetDfsGetClientInfo 和 NetDfsGetInfo 函数以及 FSCTL_DFS_GET_PKT_ENTRY_STATE 控制代码。
语法
typedef struct _DFS_INFO_4 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
DWORD NumberOfStorages;
#if ...
LPDFS_STORAGE_INFO Storage;
#else
LPDFS_STORAGE_INFO Storage;
#endif
} DFS_INFO_4, *PDFS_INFO_4, *LPDFS_INFO_4;
成员
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。
NumberOfStorages
指定 DFS 目标的数目。
Storage
指向DFS_STORAGE_INFO结构的数组 的 指针。 NumberOfStorages 成员指定数组中的结构数。
注解
DFS_INFO_4 结构包含一个或多个DFS_STORAGE_INFO结构，每个 DFS 目标对应一个结构。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 标头 | lmdfs.h (包括 LmDfs.h、Lm.h) |