DFS_INFO_6 結構 (lmdfs.h)

發行項
02/28/2024

包含分散式文件系統 (DFS) 根或連結的相關信息。此結構包含名稱、狀態、 GUID、逾時、命名空間/根/鏈接屬性、元數據大小、目標數目，以及根或連結之每個目標的相關信息。這個結構僅適用於 NetDfsEnum、 NetDfsGetClientInfo 和 NetDfsGetInfo 函式。

若要在沒有目標信息的情況下取得 DFS 命名空間的相關信息，請改用 DFS_INFO_5 。

語法

typedef struct _DFS_INFO_6 {
  LPWSTR               EntryPath;
  LPWSTR               Comment;
  DWORD                State;
  ULONG                Timeout;
  GUID                 Guid;
  ULONG                PropertyFlags;
  ULONG                MetadataSize;
  DWORD                NumberOfStorages;
#if ...
  LPDFS_STORAGE_INFO_1 Storage;
#else
  LPDFS_STORAGE_INFO_1 Storage;
#endif
} DFS_INFO_6, *PDFS_INFO_6, *LPDFS_INFO_6;

成員

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 。

PropertyFlags

指定一組旗標，描述 DFS 命名空間、根或連結的特定屬性。

DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)

範圍：網域根目錄、獨立根目錄和連結。如果此旗標是在 DFS 根目錄設定，則會套用至所有連結;否則，會針對每個個別鏈接考慮此旗標的值。

設定此旗標時，DFS 伺服器針對 DFS 根目錄或啟用「INSITE」選項的連結，DFS 轉介回應只會包含與要求轉介之 DFS 用戶端位於相同網站中的目標。不論其月臺位置為何，都會傳回兩個全域優先順序類別中的目標。

DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)

範圍：僅限網域型 DFS 命名空間的整個 DFS 命名空間。

根據預設，DFS 根目標伺服器會輪詢 PDS 以偵測 DFS 元數據的變更。若要防止 PDC 上的大量伺服器負載，可以針對 DFS 命名空間啟用根延展性。設定此旗標會導致 DFS 伺服器輪詢最接近的域控制器，而不是針對通用命名空間進行 DFS 元數據變更的 PDC。請注意，對元數據所做的任何變更仍必須在 PDC 上發生。

DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)

範圍：網域型和獨立 DFS 命名空間的整個 DFS 命名空間。

根據預設，從 DFS 伺服器到 DFS 根目錄或連結之 DFS 用戶端的轉介回應中傳回的目標包含兩個群組：與客戶端位於相同網站的目標，以及網站外部的目標。

如果已啟用 Active Directory 的月臺成本，回應可以有兩個以上的群組，每個群組包含目標，且特定 DFS 用戶端要求轉介的目標相同網站成本。群組會依增加網站成本來排序。如需月臺成本如何用來設定目標優先順序的詳細資訊，請參閱 DFS 伺服器目標優先順序。

DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)

範圍：網域型 DFS 根目錄、獨立 DFS 根目錄和 DFS 連結。如果此旗標是在 DFS 根目錄設定，則會套用至所有連結;否則，會針對每個個別鏈接考慮此旗標的值。

設定此旗標時，V4 DFS 用戶端會啟用最佳目標容錯回復，讓他們在故障轉移至非最佳目標之後容錯回復到最佳目標。目標容錯回復設定是由 DFS 伺服器在 V4 轉介回應中提供給 DFS 用戶端。

DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)

範圍：僅限獨立 DFS 根目錄和連結。

DFS 根目錄已叢集，以提供記憶體故障轉移的高可用性。無法使用 NetDfsSetInfo 函式來設定此旗標。

DFS_PROPERTY_FLAG_ABDE (0x00000020)

範圍：網域型 DFS 根目錄和獨立 DFS 根目錄。

設定此旗標時，Access-Based 目錄列舉 (ABDE) 模式支援，會在 DFS 命名空間的整個 DFS 根目標共用上啟用。此旗標僅適用於 設定DFS_NAMESPACE_CAPABILITY_ABDE 功能旗標的 DFS 命名空間。如需詳細資訊，請參閱 DFS_INFO_50 和 DFS_SUPPORTED_NAMESPACE_VERSION_INFO。

DFS_PROPERTY_FLAG_ABDE旗標僅適用於 DFS 命名空間根目錄，不適用於根目標、鏈接或鏈接目標。必須啟用此旗標，才能建立安全性描述符與 DFS 連結的關聯。

MetadataSize

對於網域型 DFS 命名空間，此成員會以位元組為單位指定對應 Active Directory 數據 Blob 的大小。針對獨立 DFS 命名空間，此欄位會指定儲存在登錄中的元數據大小，包括機碼名稱和值名稱，以及與其相關聯的特定數據項。

此欄位僅適用於 DFS 根目錄。

NumberOfStorages

指定 DFS 根或鏈接的目標數目。這些目標包含在這個結構的 記憶體 成員中。

Storage

指定包含 DFS 目標資訊的 DFS_STORAGE_INFO_1 結構陣列。