структура DSOP_INIT_INFO (objsel.h)
Структура DSOP_INIT_INFO содержит данные, необходимые для инициализации диалогового окна выбора объектов. Эта структура используется с методом IDsObjectPicker::Initialize .
Синтаксис
typedef struct _DSOP_INIT_INFO {
ULONG cbSize;
PCWSTR pwzTargetComputer;
ULONG cDsScopeInfos;
PDSOP_SCOPE_INIT_INFO aDsScopeInfos;
ULONG flOptions;
ULONG cAttributesToFetch;
PCWSTR *apwzAttributeNames;
} DSOP_INIT_INFO, *PDSOP_INIT_INFO;
Члены
cbSize
Содержит размер структуры в байтах.
pwzTargetComputer
Указатель на строку Юникода, завершающуюся null, которая содержит имя целевого компьютера. Диалоговое окно работает так, как если бы оно выполнялось на целевом компьютере, используя целевой компьютер для определения присоединенного домена и предприятия. Если это значение равно NULL, конечным компьютером является локальный компьютер.
cDsScopeInfos
Указывает количество элементов в массиве aDsScopeInfos .
aDsScopeInfos
Указатель на массив DSOP_SCOPE_INIT_INFO структур, описывающих области, из которых пользователь может выбирать объекты. Этот элемент не может иметь значение NULL, и массив должен содержать по крайней мере один элемент, так как средство выбора объектов не может работать без по крайней мере одного область.
flOptions
Флаги, определяющие параметры средства выбора объектов. Этот элемент может быть нулевым или сочетанием одного или нескольких следующих флагов.
DSOP_FLAG_MULTISELECT (0x00000001)
Если этот флаг установлен, пользователь может выбрать несколько объектов. Если этот флаг не установлен, пользователь может выбрать только один объект.
DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x00000002)
Если этот флаг установлен и в массиве aDsScopeInfos установлен флаг DSOP_SCOPE_TYPE_TARGET_COMPUTER, целевой компьютер всегда включается в раскрывающийся список Поиск в.
Если этот флаг не установлен и конечный компьютер является контроллером домена верхнего или нижнего уровня, флаг DSOP_SCOPE_TYPE_TARGET_COMPUTER игнорируется и целевой компьютер не включается в раскрывающийся список Поиск в .
Чтобы сэкономить время во время инициализации, этот флаг следует установить, если известно, что целевой компьютер не является контроллером домена. Однако если целевой компьютер является контроллером домена, этот флаг устанавливать не следует, так как пользователю лучше выбирать объекты домена из область домена, а не из самого контроллера домена.
cAttributesToFetch
Содержит количество элементов в массиве apwzAttributeNames . Этот элемент может быть равен нулю.
apwzAttributeNames
Указатель на массив строк Юникода, заканчивающихся nullом, которые содержат имена атрибутов, извлекаемых для каждого выбранного объекта. Если cAttributesToFetch равно нулю, этот элемент игнорируется.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Верхняя часть | objsel.h |