Структура DSQUERYINITPARAMS (dsquery.h)

Статья
03/09/2024

Структура DSQUERYINITPARAMS описывает данные, используемые для инициализации диалогового окна обзора в запросе службы каталогов.

Синтаксис

typedef struct {
  DWORD  cbStruct;
  DWORD  dwFlags;
  LPWSTR pDefaultScope;
  LPWSTR pDefaultSaveLocation;
  LPWSTR pUserName;
  LPWSTR pPassword;
  LPWSTR pServer;
} DSQUERYINITPARAMS, *LPDSQUERYINITPARAMS;

Члены

cbStruct

Содержит размер этой структуры в байтах.

dwFlags

Содержит набор флагов, определяющих поведение запроса. Это может быть ноль или сочетание одного или нескольких из следующих значений.

DSQPF_ENABLEADMINFEATURES

Использует функции, поддерживаемые средствами администрирования службы каталогов, такими как описатель отображения Администратор для контекстных меню и страниц свойств.

DSQPF_ENABLEADVANCEDFEATURES

Указывает расширенные функции в экземпляре IDataObject, передаваемые в контекстные меню и страницы свойств.

DSQPF_HASCREDENTIALS

Элементы pUserName, pPassword и pServer этой структуры могут указывать данные сервера и учетных данных.

DSQPF_NOCHOOSECOLUMNS

Отключает элемент Выбор столбцов в меню "Вид " диалогового окна запроса.

DSQPF_NOSAVE

Удаляет элемент "Сохранить поиск " из меню "Файл " диалогового окна запроса.

DSQPF_SAVELOCATION

Элемент pDefaultSaveLocation содержит путь к файловой системе по умолчанию, в котором будут сохраняться поисковые запросы.

DSQPF_SHOWHIDDENOBJECTS

Вызывает отображение скрытых объектов в списке результатов запроса в диалоговом окне запроса.

pDefaultScope

Указатель на строку Юникода, завершающуюся null, которая содержит ADsPath область по умолчанию для поиска. Если область поиска по умолчанию не указан, задайте для этого элемента значение NULL.

pDefaultSaveLocation

Указатель на строку Юникода, завершающуюся значением NULL, которая содержит путь к файловой системе по умолчанию, в которой будут сохранены поисковые запросы. Этот элемент игнорируется, если элемент dwFlags не содержит DSQPF_SAVELOCATION.

pUserName

Указатель на строку Юникода, завершающуюся null, которая содержит имя пользователя в допустимой нотации домена, например fabrikam\jeffsmith.

pPassword

Указатель на строку Юникода, завершающуюся null, которая содержит пароль пользователя, указанного членом pUserName .

pServer

Указатель на строку Юникода с пустым завершением, содержащую имя сервера, с которого считывается список доверенных доменов. Этот список используется для заполнения раскрывающегося списка In: в диалоговом окне.

Эта структура зависит от обработчика запросов CLSID_DsQuery . Эта структура используется для элемента pHandlerParameters структуры OPENQUERYWINDOW , если CLSID_DsQuery задано для элемента clsidHandler структуры OPENQUERYWINDOW . Дополнительные сведения и пример кода для использования этого и других связанных API см. в разделе ICommonQuery::OpenQueryWindow.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Верхняя часть	dsquery.h