Структура OPENQUERYWINDOW (cmnquery.h)
Структура OPENQUERYWINDOW используется с методом ICommonQuery::OpenQueryWindow для инициализации диалогового окна запроса службы каталогов.
Синтаксис
typedef struct {
DWORD cbStruct;
DWORD dwFlags;
CLSID clsidHandler;
LPVOID pHandlerParameters;
CLSID clsidDefaultForm;
IPersistQuery *pPersistQuery;
union {
void *pFormParameters;
IPropertyBag *ppbFormParameters;
};
} OPENQUERYWINDOW, *LPOPENQUERYWINDOW;
Члены
cbStruct
Содержит размер структуры в байтах. Этот элемент используется для управления версиями и проверки параметров и должен быть заполнен перед вызовом ICommonQuery::OpenQueryWindow.
dwFlags
Содержит набор флагов, определяющих поведение диалогового окна запроса службы каталогов. Это может быть ноль или сочетание одного или нескольких значений, перечисленных в следующем списке.
OQWF_DEFAULTFORM
Заставляет диалоговое окно запроса выбрать форму, указанную элементом clsidDefaultForm при инициализации.
OQWF_HIDEMENUS
Вызывает скрытие строки меню в диалоговом окне.
OQWF_HIDESEARCHUI
Вызывает создание диалогового окна запроса без стандартного пользовательского интерфейса поиска. Сюда входят кнопки Найти сейчас, Остановить и Очистить все .
OQWF_ISSUEONOPEN
Вызывает выполнение запроса при первом отображении диалогового окна запроса.
OQWF_LOADQUERY
Вызывает диалоговое окно запроса для получения запроса из интерфейса IPersistQuery в элементе pPersistQuery .
OQWF_OKCANCEL
Вызывает отображение кнопок ОК и Отмена в диалоговом окне запроса, если применимо. Фактические кнопки, отображаемые в диалоговом окне, будут зависеть от используемой формы и других указанных флагов.
OQWF_PARAMISPROPERTYBAG
Указывает, что элемент ppbFormParameters содержит интерфейс IPropertyBag .
OQWF_REMOVEFORMS
Вызывает создание диалогового окна запроса без метки выбора формы и раскрывающегося списка, представленного меткой Найти .
OQWF_REMOVESCOPES
Вызывает создание диалогового окна запроса без метки область и раскрывающегося списка, представленных меткой In: .
OQWF_SAVEQUERYONOK
Вызывает диалоговое окно запроса при закрытии для сохранения запроса в интерфейсЕ IPersistQuery в элементе pPersistQuery .
OQWF_SHOWOPTIONAL
Вызывает отображение необязательных форм в раскрывающемся списке формы в диалоговом окне запроса. Необязательные формы — это формы, указывающие флаг CQFF_ISOPTIONAL в элементе dwFlags структуры CQFORM .
OQWF_SINGLESELECT
Заставляет диалоговое окно запроса сделать список результатов запроса одним выбором.
clsidHandler
Содержит значение CLSID , указывающее обработчик запроса, используемый диалоговым окном запроса. Значение этого элемента также определяет тип структуры, на которую указывает элемент pHandlerParameters .
CLSID_DsQuery
Это стандартный запрос службы каталогов и единственный поддерживаемый в настоящее время запрос.
pHandlerParameters
Указатель на структуру, содержащую данные для обработчика запросов. Тип структуры, на которую указывает этот элемент, определяется элементом clsidHandler . В следующем списке перечислены возможные типы структур на основе значения элемента clsidHandler .
CLSID_DsQuery
Содержит указатель на структуру DSQUERYINITPARAMS .
clsidDefaultForm
Указывает форму по умолчанию, отображаемую в диалоговом окне запроса. Этот элемент игнорируется, если dwFlags не содержит OQWF_DEFAULTFORM. Этот элемент может содержать CLSID настраиваемой формы запроса или одной из форм, предоставляемых системой.
CLSID_DsFindAdvanced
Идентифицирует форму запроса пользовательского поиска .
CLSID_DsFindComputer
Идентифицирует форму запроса Компьютеры .
CLSID_DsFindContainer
Идентифицирует форму запроса организационных подразделений .
CLSID_DsFindDomainController
Определяет форму запроса контроллеров домена .
CLSID_DsFindFrsMembers
Идентифицирует форму запроса членов FRS .
CLSID_DsFindObjects
Зарезервировано.
CLSID_DsFindPeople
Идентифицирует форму запроса "Пользователи", "Контакты" и "Группы ".
CLSID_DsFindPrinter
Идентифицирует форму запроса принтеров .
CLSID_DsFindVolume
Идентифицирует форму запроса общих папок .
CLSID_DsFindWriteableDomainController
Определяет форму запроса контроллеров домена и отображает доступные для записи контроллеры домена.
pPersistQuery
Указатель на интерфейс IPersistQuery, используемый для хранения и извлечения данных запроса. Эти данные относятся к самому запросу, а не к результатам запроса. Если dwFlags содержит OQWF_LOADQUERY, данные запроса получаются из этого интерфейса. Если dwFlags содержит OQWF_SAVEQUERY, данные запроса сохраняются в этом интерфейсе.
pFormParameters
Зарезервировано. Указатель на структуру или интерфейс, предоставляющий данные инициализации параметров для формы. Содержимое этого указателя определяется классом формы, заданным элементом clsidDefaultForm .
ppbFormParameters
Указатель на интерфейс IPropertyBag , предоставляющий данные инициализации параметров для формы. Содержимое этого контейнера свойств определяется классом формы, заданным элементом clsidDefaultForm . Следующие формы, предоставляемые системой, поддерживают этот элемент.
CLSID_DsFindPrinter
Эта форма получает следующие свойства из контейнера свойств.
| Имя свойства | Описание |
|---|---|
| printName | Содержит имя исходного принтера. |
| printLocation | Содержит начальное расположение принтера. |
| printModel | Содержит начальное имя модели и(или) номер принтера. |
CLSID_DsFindComputer
Используйте эту форму для указания ролей компьютера. Контейнер свойств должен содержать computerRole. Используйте сочетание следующих значений, чтобы ограничить включенные роли:
| Значение | Роль |
|---|---|
| 0x0000 | Все роли |
| 0x0001 | Рабочая станция или сервер |
| 0x0002 | Все контроллеры домена |
| 0x0004 | Контроллеры домена, доступные для записи |
| 0x0008 | Контроллеры домена только для чтения |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Верхняя часть | cmnquery.h |