Метод IOleCommandTarget::QueryStatus (docobj.h)

Запрашивает объект о состоянии одной или нескольких команд, созданных событиями пользовательского интерфейса.

Синтаксис

HRESULT QueryStatus(
  [in]      const GUID *pguidCmdGroup,
  [in]      ULONG      cCmds,
  [in, out] OLECMD []  prgCmds,
  [in, out] OLECMDTEXT *pCmdText
);

Параметры

[in] pguidCmdGroup

Уникальный идентификатор группы команд; Может иметь значение NULL , чтобы указать стандартную группу. Все команды, передаваемые в массиве prgCmds , должны принадлежать группе, указанной в pguidCmdGroup.

[in] cCmds

Количество команд в массиве prgCmds .

[in, out] prgCmds

Выделенный вызывающим объектом массив структур OLECMD , указывающий команды, для которых вызывающему объекту требуются сведения о состоянии. Этот метод заполняет элемент cmdf каждой структуры значениями, взятыми из перечисления OLECMDF .

[in, out] pCmdText

Указатель на структуру OLECMDTEXT , в которой возвращается имя и (или) сведения о состоянии одной команды. Этот параметр может иметь значение NULL , чтобы указать, что вызывающий объект не нуждается в этих сведениях.

Возвращаемое значение

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата	Описание
E_FAIL	Операция не удалась.
E_UNEXPECTED	Произошла непредвиденная ошибка.
E_POINTER	Аргумент prgCmds имеет значение NULL.
OLECMDERR_E_UNKNOWNGROUP	Параметр pguidCmdGroup не имеет значения NULL , но не указывает распознаваемую группу команд.

Комментарии

Вызывающие объекты используют QueryStatus , чтобы определить, какие команды поддерживаются целевым объектом. Затем вызывающий объект может отключить недоступные команды, которые в противном случае были бы перенаправлены в объект . Вызывающий объект также может использовать этот метод для получения имени или состояния одной команды.

Требования

Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	docobj.h

См. также раздел

IOleCommandTarget

OLECMD

OLECMDF

OLECMDTEXT