Метод IOleObject::GetMiscStatus (oleidl.h)

Статья
08/25/2023

Извлекает состояние объекта при создании и загрузке.

Синтаксис

HRESULT GetMiscStatus(
  [in]  DWORD dwAspect,
  [out] DWORD *pdwStatus
);

Параметры

[in] dwAspect

Аспект объекта, о котором запрашиваются сведения о состоянии. Значение получается из перечисления DVASPECT.

[out] pdwStatus

Указатель на то место, в которое возвращены сведения о состоянии. Этот параметр не может иметь значение NULL.

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

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

Код возврата	Описание
OLE_S_USEREG	Делегируйте получение прочих сведений о состоянии реализации этого метода обработчиком по умолчанию.
CO_E_CLASSNOTREG	Для объекта не зарегистрирован clSID.
CO_E_READREGDB	Ошибка при доступе к реестру.

Объекты хранят сведения о состоянии в реестре. Если объект не запущен, реализация обработчика по умолчанию IOleObject::GetMiscStatus извлекает эти сведения из реестра. Если объект запущен, обработчик по умолчанию вызывает IOleObject::GetMiscStatus для самого объекта.

Сведения, фактически хранящиеся в реестре, зависят от отдельных объектов. Возвращаемые значения состояния определяются в перечислении OLEMISC.

Значение по умолчанию IOleObject::GetMiscStatus используется, если не найден подраздел, соответствующий указанному DVASPECT . Чтобы задать элемент управления OLE, укажите DVASPECT==1. Это приведет к возникновению следующих действий в реестре:

HKEY_CLASSES_ROOT\CLSID\ . . .
   MiscStatus = 1

Примечания для разработчиков

Реализация обычно состоит из делегирования вызова обработчику по умолчанию.

Требования

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

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