Метод IOleWindow::GetWindow (oleidl.h)

Статья
08/25/2023

Извлекает дескриптор для одного из окон, участвующих в активации на месте (окно фрейма, документа, родительского окна или окна объектов на месте).

Синтаксис

HRESULT GetWindow(
  [out] HWND *phwnd
);

Параметры

[out] phwnd

Указатель на переменную, которая получает дескриптор окна.

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

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

Код возврата	Описание
E_FAIL	Объект не является оконным.
E_INVALIDARG	Указанное значение fEnterMode недопустимо.
E_OUTOFMEMORY	Недостаточно доступной памяти для этой операции.
E_UNEXPECTED	Произошла непредвиденная ошибка.

Окно	Описание
Frame	Самое внешнее окно main, в котором находится меню main приложения-контейнера.
Документ	Окно, в котором отображается составной документ, содержащий внедренный объект для пользователя.
Панель	Подокно окна документа, содержащего представление объекта. Применимо только для приложений с окнами с разделенной панелью.
Parent	Окно контейнера, содержащее представление этого объекта. Приложение-объект устанавливает свое окно в качестве дочернего элемента этого окна.
на месте;	Окно, содержащее активный объект на месте. Приложение-объект создает это окно и устанавливает его в качестве дочернего элемента окна штриховки, которое является дочерним по отношению к родительскому окну контейнера.

Каждый тип окна имеет разную роль в архитектуре активации на месте. Однако нет необходимости использовать отдельное физическое окно для каждого типа. Многие приложения-контейнеры используют одно и то же окно для своих фреймов, документов, панелей и родительских окон.

Требования


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

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

IOleWindow