Поделиться через


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

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

Синтаксис

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 извлекает эти сведения из реестра. Если объект запущен, обработчик по умолчанию вызывает 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

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

DVASPECT

FORMATETC

IOleObject

OLEMISC