Compartir a través de


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