DFS_INFO_107 結構 (lmdfs.h)
包含 DFS 根或連結的相關信息,包括批註、狀態、逾時、屬性旗標,以及連結重新分析點安全性描述元。 此結構僅適用於 NetDfsGetInfo 和 NetDfsSetInfo 函 式。
語法
typedef struct _DFS_INFO_107 {
LPWSTR Comment;
DWORD State;
ULONG Timeout;
ULONG PropertyFlagMask;
ULONG PropertyFlags;
ULONG SecurityDescriptorLength;
#if ...
PUCHAR pSecurityDescriptor;
ULONG SdLengthReserved;
#else
PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
} DFS_INFO_107, *PDFS_INFO_107, *LPDFS_INFO_107;
成員
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 根目錄或連結的逾時,以秒為單位。
PropertyFlagMask
指定遮罩值,指出哪些旗標在 PropertyFlags 字段中評估有效。
PropertyFlags
Bitfield,每個位負責特定屬性適用於整個 DFS 命名空間、DFS 根目錄或個別 DFS 連結,視實際屬性而定。 除非另有指示,否則允許任何位組合。
DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)
DFS 根目錄或連結的 DFS 伺服器轉介回應,該根目錄或連結只包含與要求轉介之用戶端相同的網站中的目標。 不論其月臺位置為何,一律會傳回兩個全域優先順序類別中的目標。 此旗標適用於網域型 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_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
如果設定此旗標,則會將 DFS 根目錄叢集化以提供記憶體故障轉移的高可用性。 您無法使用 NetDfsSetInfo 函式來設定此旗標,而且僅適用於獨立 DFS 根目錄和連結。
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 連結的關聯。
SecurityDescriptorLength
pSecurityDescriptor
SECURITY_DESCRIPTOR 結構的指標,指定要與 DFS 連結重新分析點相關聯的自我相對安全性描述項。 此欄位僅適用於 DFS 連結。
SdLengthReserved
此成員保留供系統使用。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista SP1 |
最低支援的伺服器 | Windows Server 2008 |
標頭 | lmdfs.h (包括 LmDfs.h、Lm.h) |