DFS_INFO_105結構 (lmdfs.h)

發行項
08/24/2023

包含 DFS 根或連結的相關資訊，包括屬性旗標所指定的批註、狀態、逾時和 DFS 行為。此結構僅適用于 NetDfsSetInfo 函式。

語法

typedef struct _DFS_INFO_105 {
  LPWSTR Comment;
  DWORD  State;
  ULONG  Timeout;
  ULONG  PropertyFlagMask;
  ULONG  PropertyFlags;
} DFS_INFO_105, *PDFS_INFO_105, *LPDFS_INFO_105;

成員

Comment

Null 終止的 Unicode 字串指標，其中包含與 DFS 根或連結相關聯的批註。

State

指定描述 DFS 根目錄或連結狀態的一組位旗標;無法變更 DFS 命名空間根目錄的狀態。設定一個 DFS_VOLUME_STATE 旗標，並設定一個 DFS_VOLUME_FLAVOR 旗標。如需描述這些旗標解譯的範例，請參閱 DFS_INFO_2的一節。

預設 (0x00000000)

保留現有的狀態。

DFS_VOLUME_STATE_OK (0x00000001)

指定的 DFS 根或連結處於正常狀態。

DFS_VOLUME_STATE_OFFLINE (0x00000003)

指定的 DFS 根目錄或連結離線或無法使用。

DFS_VOLUME_STATE_ONLINE (0x00000004)

指定的 DFS 根目錄或連結可供使用。

Timeout

指定 DFS 根目錄或連結的逾時，以秒為單位。

PropertyFlagMask

指定遮罩值，指出哪些旗標在 PropertyFlags 欄位中評估有效。

PropertyFlags

Bitfield，每個位負責特定屬性適用于整個 DFS 命名空間、DFS 根目錄或個別 DFS 連結，視實際屬性而定。除非另有指示，否則允許任何位組合。

DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)

DFS 根目錄或連結的 DFS 伺服器轉介回應，該根目錄或連結只包含與要求轉介之用戶端相同的網站中的目標。兩個全域優先順序類別中的目標一律會傳回，與其月臺位置無關。此旗標適用于網域型 DFS 根目錄、獨立根目錄和連結。如果此旗標設定于 DFS 根目錄，則會套用至所有連結;否則，它會套用至個別連結。連結上的設定不會覆寫根設定。

DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)

如果設定此旗標，DFS 伺服器會輪詢最接近的網域控制站 (DC) ，而不是 (PDC) 的主要網域控制站，以檢查該命名空間的 DFS 命名空間變更。 DFS 伺服器對 DFS 中繼資料所做的任何修改都不受此旗標控制，而是會自動傳送至 PDC。此旗標適用于整個命名空間，而且僅適用于網域型 DFS 命名空間。

DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)

設定此旗標以啟用目標的 Active Directory 網站成本。從 DFS 伺服器傳回至要求 DFS 用戶端的目標，會依與 DFS 用戶端相關的月臺間成本分組。群組會依增加網站成本來排序，而第一個群組是由與用戶端位於相同網站中的目標所組成。每個群組內的目標都會隨機排序。

如果未啟用此旗標，預設傳回會是兩組：一組目標與用戶端位於相同的網站，以及一組所有剩餘的目標。此旗標適用于整個 DFS 命名空間，而且同時適用于網域型和獨立 DFS 命名空間。

目標優先順序可以進一步影響目標順序。如需如何使用月臺成本來設定目標優先順序的詳細資訊，請參閱 DFS 伺服器目標優先順序。

DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)

設定此旗標可讓 V4 DFS 用戶端容錯回復到較佳 (較低成本或優先順序較高的) 目標。如果此旗標設定于 DFS 根目錄，則會套用至所有連結;否則，它會套用至個別連結。個別連結設定不會覆寫根設定。目標容錯回復設定會提供給 DFS 伺服器 V4 轉介回應中的 DFS 用戶端。此旗標適用于網域型 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 連結的關聯。