Método IOleWindow::GetWindow (oleidl.h)

Recupera un identificador de una de las ventanas que participan en la activación local (marco, documento, primario o ventana de objeto en contexto).

Sintaxis

HRESULT GetWindow(
  [out] HWND *phwnd
);

Parámetros

[out] phwnd

Puntero a una variable que recibe el identificador de ventana.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_FAIL	El objeto no tiene ventana.
E_INVALIDARG	El valor fEnterMode especificado no es válido.
E_OUTOFMEMORY	No hay suficiente memoria disponible para esta operación.
E_UNEXPECTED	Se produjo un error inesperado.

Comentarios

Cinco tipos de ventanas componen la jerarquía de ventanas. Cuando un objeto está activo en su lugar, tiene acceso a algunas o todas estas ventanas.

Periodo	Descripción
Fotograma	La ventana principal más externa donde reside el menú principal de la aplicación contenedora.
Documento	Ventana que muestra el documento compuesto que contiene el objeto incrustado al usuario.
Panel	Subventana de la ventana del documento que contiene la vista del objeto. Solo se aplica a las aplicaciones con ventanas de panel dividido.
Parent	Ventana contenedora que contiene la vista del objeto. La aplicación de objeto instala su ventana como elemento secundario de esta ventana.
In situ	Ventana que contiene el objeto activo en contexto. La aplicación de objeto crea esta ventana e la instala como elemento secundario de su ventana de sombreado, que es un elemento secundario de la ventana primaria del contenedor.

 

Cada tipo de ventana tiene un rol diferente en la arquitectura de activación local. Sin embargo, no es necesario emplear una ventana física independiente para cada tipo. Muchas aplicaciones contenedoras usan la misma ventana para sus ventanas marco, documento, panel y primario.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleidl.h

Consulte también

IOleWindow