lmdfs.h) (DFS_INFO_3 结构

项目
02/28/2024

包含有关分布式文件系统的信息 (DFS) 根或链接。此结构包含名称、状态、DFS 目标数以及有关根或链接的每个目标的信息。此结构仅用于 NetDfsEnum、 NetDfsGetClientInfo 和 NetDfsGetInfo 函数以及 FSCTL_DFS_GET_PKT_ENTRY_STATE 控制代码。

语法

typedef struct _DFS_INFO_3 {
  LPWSTR             EntryPath;
  LPWSTR             Comment;
  DWORD              State;
  DWORD              NumberOfStorages;
#if ...
  LPDFS_STORAGE_INFO Storage;
#else
  LPDFS_STORAGE_INFO Storage;
#endif
} DFS_INFO_3, *PDFS_INFO_3, *LPDFS_INFO_3;

成员

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 的“备注”部分。