Метод 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 при успешном завершении. Другие возможные возвращаемые значения включают следующее.
| Код возврата | Описание |
|---|---|
|
Операция не удалась. |
|
Произошла непредвиденная ошибка. |
|
Аргумент prgCmds имеет значение NULL. |
|
Параметр pguidCmdGroup не имеет значения NULL , но не указывает распознаваемую группу команд. |
Комментарии
Вызывающие объекты используют QueryStatus , чтобы определить, какие команды поддерживаются целевым объектом. Затем вызывающий объект может отключить недоступные команды, которые в противном случае были бы перенаправлены в объект . Вызывающий объект также может использовать этот метод для получения имени или состояния одной команды.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | docobj.h |