структура DSOP_SCOPE_INIT_INFO (objsel.h)
Структура DSOP_SCOPE_INIT_INFO описывает один или несколько типов область с одинаковыми атрибутами. Тип область — это тип расположения, например домен, компьютер или глобальный каталог, из которого пользователь может выбирать объекты. Эта структура используется с DSOP_INIT_INFO при вызове IDsObjectPicker::Initialize.
Синтаксис
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)
Компьютер, заданный членом pwzTargetComputerструктуры DSOP_INIT_INFO .
Если целевой компьютер является контроллером домена верхнего или нижнего уровня, этот флаг игнорируется, если флаг DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK не установлен в элементе flOptionsструктуры DSOP_INIT_INFO .
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 также может указывать начальные область, отображаемые в раскрывающемся списке Look in (Поиск в). Этот элемент может быть сочетанием следующих флагов.
Пути LDAP и глобального каталога (GC) можно преобразовать в синтаксис WinNT ADsPath. Пути сборки мусора можно преобразовать в формат LDAP. Объекты WinNT с атрибутом objectSid можно преобразовать в формат LDAP, если заданы флаги DSOP_SCOPE_FLAG_WANT_SID_PATH или DSOP_SCOPE_FLAG_WANT_PROVIDER_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 для объектов, выбранных из этого область, преобразуются для использования поставщика сборки мусора.
DSOP_SCOPE_FLAG_WANT_SID_PATH (0x00000010)
ADsPaths с атрибутом objectSid преобразуются в форму LDAP://< SID=x> , где x представляет шестнадцатеричные цифры значения атрибута objectSid.
DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)
ADsPaths для хорошо известных объектов SID нижнего уровня являются пустой строкой, если не указан этот флаг (например; 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
Указатель на строку Юникода с пустым завершением, содержащую имя контроллера домена домена, к которому присоединен целевой компьютер. Этот элемент используется только в том случае, если элемент flType содержит флаг DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN . Если этот флаг не задан, значение pwzDcName должно иметь значение NULL.
Этот член может иметь значение NULL , даже если указан флаг DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN . В этом случае диалоговое окно ищет контроллер домена. Этот член позволяет присвоить имя определенному контроллеру домена в домене с несколькими администраторами. Например, административное приложение может внести изменения в контроллер домена в домене multimaster, а затем открыть диалоговое окно выбора объектов, прежде чем изменения будут реплицированы на другие контроллеры домена.
pwzADsPath
Защищены; значение должно иметь значение NULL.
hr
Содержит значение HRESULT, указывающее состояние конкретного область. Если метод IDsObjectPicker::Initialize успешно создает область или области, заданные этой структурой, hr содержит S_OK. В противном случае hr содержит код ошибки.
Если IDsObjectPicker::Initialize возвращает S_OK, члены hr всех указанных DSOP_SCOPE_INIT_INFO структур также содержат S_OK.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Верхняя часть | objsel.h |