DFS_INFO_8 結構 (lmdfs.h)
包含根或連結的名稱、狀態、 GUID、逾時、屬性旗標、中繼資料大小、DFS 目標資訊,以及連結重新分析點安全性描述元。 此結構僅適用于 NetDfsGetInfo 和 NetDfsEnum 函式。
語法
typedef struct _DFS_INFO_8 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
ULONG PropertyFlags;
ULONG MetadataSize;
ULONG SecurityDescriptorLength;
#if ...
PUCHAR pSecurityDescriptor;
ULONG SdLengthReserved;
#else
PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
DWORD NumberOfStorages;
} DFS_INFO_8, *PDFS_INFO_8, *LPDFS_INFO_8;
成員
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 根目錄。
SecurityDescriptorLength
pSecurityDescriptor
SECURITY_DESCRIPTOR結構的指標,指定要與 DFS 連結重新分析點相關聯的自我相對安全性描述元。 此欄位僅適用于 DFS 連結。
SdLengthReserved
此成員保留供系統使用。
NumberOfStorages
指定包含 DFS 根或連結之磁片區的儲存體伺服器數目。
需求
最低支援的用戶端 | Windows Vista SP1 |
最低支援的伺服器 | Windows Server 2008 |
標頭 | lmdfs.h (包括 LmDfs.h、Lm.h) |