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 |
|---|---|
|
El objeto no tiene ventana. |
|
El valor fEnterMode especificado no es válido. |
|
No hay suficiente memoria disponible para esta operación. |
|
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 |