DSOP_SCOPE_INIT_INFO 結構 (objsel.h)
DSOP_SCOPE_INIT_INFO 結構描述一或多個具有相同屬性的範圍類型。 範圍類型是一種位置類型，例如網域、計算機或全域編錄，使用者可以從中選取物件。 呼叫 IDsObjectPicker：：Initialize 時，這個結構會與 DSOP_INIT_INFO 搭配使用。
語法
typedef struct _DSOP_SCOPE_INIT_INFO {
ULONG cbSize;
ULONG flType;
ULONG flScope;
DSOP_FILTER_FLAGS FilterFlags;
PCWSTR pwzDcName;
PCWSTR pwzADsPath;
HRESULT hr;
} DSOP_SCOPE_INIT_INFO, *PDSOP_SCOPE_INIT_INFO;
成員
cbSize
包含 結構的大小，以位元組為單位。
flType
旗標，指出這個 結構所描述的範圍類型。 如果所有指定的範圍都使用相同的設定，您可以結合多個範圍類型。 這個成員可以是下列旗標的組合。
DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x00000001)
DSOP_INIT_INFO 結構之 pwzTargetComputer 成員所指定的計算機。
如果目標計算機是上層或下層域控制器，除非DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK旗標是在 DSOP_INIT_INFO 結構的 flOptions 成員中設定，否則會忽略此旗標。
DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN (0x00000002)
已加入目標計算機的上層網域。 如果設定此旗標，請使用 pwzDcName 成員來指定已加入網域中的域控制器名稱。
DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x00000004)
已加入目標計算機的下層網域。
DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN (0x00000008)
目標計算機所屬企業中的所有網域。 如果指定 DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN 範圍， 則DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN 範圍代表企業中的所有網域，但已加入的網域除外。
DSOP_SCOPE_TYPE_GLOBAL_CATALOG (0x00000010)
範圍，包含來自企業中所有網域的物件。 企業只能包含上層網域。
DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x00000020)
企業外部的所有上層網域，但受目標計算機加入所在網域信任。
DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN (0x00000040)
企業外部的所有下層網域，但受目標計算機加入的網域信任。
DSOP_SCOPE_TYPE_WORKGROUP (0x00000080)
加入目標計算機的工作組。 只有在目標計算機未加入網域時，才適用。
可從工作組選取的唯一物件類型是計算機。
DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE (0x00000100)
可讓使用者輸入上層範圍。 如果未指定 DSOP_SCOPE_TYPE_USER_ENTERED_* 類型，對話框會將使用者限制在 [ 查看 ] 下拉式清單中的範圍。
DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE (0x00000200)
可讓使用者輸入下層範圍。
flScope
旗標，指出用來傳回從這個範圍選取之物件的 ADsPath 格式。 flScope 成員也可以指出顯示在 [查看] 下拉式清單中的初始範圍。 這個成員可以是下列旗標的組合。
LDAP 和全域編錄 (GC) 路徑可以轉換成 WinNT ADsPath 語法。 GC 路徑可以轉換成 LDAP 格式。 如果您指定 DSOP_SCOPE_FLAG_WANT_SID_PATH 或 DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP 旗標，則具有 objectSid 屬性的 WinNT 物件可以轉換成 LDAP 格式。 沒有其他轉換是合法的。
DSOP_SCOPE_FLAG_STARTING_SCOPE (0x00000001)
此結構所描述的範圍一開始會在 [ 查看 ] 下拉式清單中選取。 只有一個範圍可以指定此旗標。 如果沒有範圍指定此旗標，則初始範圍是傳遞至 IDsObjectPicker：：Initialize 方法的範圍數組中第一個成功建立的範圍。
DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT (0x00000002)
ADsPaths 會轉換成使用 WinNT 提供者。 如需詳細資訊，請參閱 WinNT ADsPath。
DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP (0x00000004)
ADsPaths 會轉換成使用LDAP提供者。 如需詳細資訊，請參閱 LDAP ADsPath。
DSOP_SCOPE_FLAG_WANT_PROVIDER_GC (0x00000008)
從這個範圍選取之物件的 ADsPaths 會轉換成使用 GC 提供者。
DSOP_SCOPE_FLAG_WANT_SID_PATH (0x00000010)
具有 objectSid 屬性的 ADsPaths 會轉換成格式 LDAP://< SID=x> ，其中 x 代表 objectSid 屬性值的十六進位數位。
DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)
下層已知 SID 物件的 ADsPaths 是空字串，除非指定此旗標 (例如; DSOP_DOWNLEVEL_FILTER_INTERACTIVE) 。 如果指定此旗標，則路徑具有窗體
WinNT://NT AUTHORITY/Interactive 或 WinNT://Creator 擁有者。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS (0x00000040)
如果範圍篩選包含使用者，請選取對話方塊中的 [ 使用者 ] 複選框。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS (0x00000080)
如果範圍篩選包含群組，請選取對話方塊中的 [ 群組 ] 複選框。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS (0x00000100)
如果範圍篩選包含計算機，請選擇對話方塊中的 [ 計算機 ] 複選框。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x00000200)
如果範圍篩選包含聯繫人，請選取對話方塊中的 [ 連絡人] 複選框。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS (0x00000400)
如果範圍篩選包含服務帳戶，請選取對話框中的服務 帳戶 和 群組受控服務帳戶 複選框。
DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS (0x00000800)
如果範圍篩選包含密碼設定物件，請選擇對話框中的 [ 密碼設定物件 ] 複選框。
FilterFlags
包含 一個DSOP_FILTER_FLAGS 結構，指出針對此範圍或範圍向用戶呈現的物件類型。
pwzDcName
Null 終止的 Unicode 字串指標，其中包含目標計算機所加入之網域的域控制器名稱。 只有當 flType 成員包含 DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN 旗標時，才會使用此成員。 如果未設定該旗標， pwzDcName 必須是 NULL。
即使指定DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN旗標，此成員仍可為 NULL，在此情況下，對話框會查閱域控制器。 此成員可讓您在多宿主網域中命名特定的域控制器。 例如，系統管理應用程式可能會在多宿主網域中的域控制器上進行變更，然後在其他域控制器上複寫變更之前開啟物件選擇器對話方塊。
pwzADsPath
保留;必須是 NULL。
hr
包含 HRESULT 值，指出特定範圍的狀態。 如果 IDsObjectPicker：：Initialize 方法成功建立此結構所指定的範圍或範圍， 則 hr 會包含 S_OK。 否則， hr 會包含錯誤碼。
如果 IDsObjectPicker：：Initialize 傳回S_OK，則所有指定之DSOP_SCOPE_INIT_INFO結構的 hr 成員也包含S_OK。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 標頭 | objsel.h |