Метод IOleDocument::GetDocMiscStatus (docobj.h)

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

Синтаксис

HRESULT GetDocMiscStatus(
  [out] DWORD *pdwStatus
);

Параметры

[out] pdwStatus

Указатель на сведения о поддерживаемых поведениях. Возможные значения взяты из перечисления DOCMISC .

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

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

Код возврата	Описание
E_POINTER	Адрес в pdwStatus имеет значение NULL.

Комментарии

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

Значения из этого перечислителя также хранятся в реестре в качестве значения раздела DocObject.

Примечания к вызывающим абонентам

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

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

Этот метод должен быть полностью реализован в любом объекте документа, даже если разыменовываемое значение pdwStatus равно нулю. E_NOTIMPL не является допустимым возвращаемым значением. Как правило, возвращаемое значение DOCMISC должно быть жестко запрограммировано для повышения производительности.

Требования

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

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

DOCMISC

IOleDocument