DFS_INFO_4 结构 (lmdfs.h)

项目
03/09/2024

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

另请参阅

通过