DFS_INFO_2 結構 (lmdfs.h)

發行項
08/24/2023

包含分散式檔案系統 (DFS) 根或連結的相關資訊。此結構包含根或連結的名稱、狀態和 DFS 目標數目。這個結構僅適用于 NetDfsEnum、 NetDfsGetClientInfo和 NetDfsGetInfo 函式和 FSCTL_DFS_GET_PKT_ENTRY_STATE 控制項程式碼。

語法

typedef struct _DFS_INFO_2 {
  LPWSTR EntryPath;
  LPWSTR Comment;
  DWORD  State;
  DWORD  NumberOfStorages;
} DFS_INFO_2, *PDFS_INFO_2, *LPDFS_INFO_2;

成員

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_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 命名空間相關聯，系統就會設定此旗標。

NumberOfStorages

指定 DFS 目標的數目。

備註

DFS 函式會使用 DFS_INFO_2 結構來擷取 DFS 根或連結的相關資訊。

以下範例描述可在 State 成員中傳回之旗標的解譯：

FlavorBits = (Flags &amp; DFS_VOLUME_FLAVORS)
If (FlavorBits == DFS_VOLUME_FLAVOR_STANDALONE)   // namespace is stand-alone DFS
else if (FlavorBits == DFS_VOLUME_FLAVOR_AD_BLOB) // namespace is AD blob
else                                              // unknown flavor

StateBits = (Flags &amp; DFS_VOLUME_STATES)
// StateBits can be one of the following: 
//  (DFS_VOLUME_STATE_OK, DFS_VOLUME_STATE_INCONSISTENT, 
//   DFS_VOLUME_STATE_OFFLINE or DFS_VOLUME_STATE_ONLINE)