DFS_INFO_5結構 (lmdfs.h)
包含分散式檔案系統 (DFS) 根或連結的相關資訊。 此結構包含根或連結的名稱、狀態、 GUID、逾時、命名空間/根/連結屬性、中繼資料大小和目標數目。 此結構僅適用于 NetDfsEnum、 NetDfsGetClientInfo和 NetDfsGetInfo 函式。
若要擷取 DFS 命名空間目標的相關資訊，請改用 DFS_INFO_6 。
語法
typedef struct _DFS_INFO_5 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
ULONG PropertyFlags;
ULONG MetadataSize;
DWORD NumberOfStorages;
} DFS_INFO_5, *PDFS_INFO_5, *LPDFS_INFO_5;
成員
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_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_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
系統會輪詢最接近的網域控制站，而不是 PDC 以進行 DFS 命名空間變更。 此旗標只適用于網域根目錄。
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
已啟用目標 Active Directory 網站成本，將目標分組成一組從 DFS 用戶端增加至目標的月臺成本。 每個集合都有具有相同成本的目標。 此旗標僅適用于網域和獨立根目錄。
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
容錯移轉至非最佳目標之後，DFS 用戶端會容錯回復到較接近可用的目標。 此旗標適用于網域和獨立根目錄和連結。
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
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 根或連結的目標數目。
備註
若要擷取目標與目標優先順序的相關資訊，請使用 DFS_INFO_6 結構。 DFS_INFO_5 可用來指定 DFS 命名空間的相關資訊，而不需要目標資訊。
需求
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008、Windows Server 2008 |
| 標頭 | lmdfs.h (包括 LmDfs.h、Lm.h) |