DFS_INFO_3結構 (lmdfs.h)

發行項
03/05/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的一節。