función IUnknown_GetWindow (shlwapi.h)

Intenta recuperar un identificador de ventana de un objeto Component Object Model (COM) consultando las distintas interfaces que tienen un método GetWindow .

Sintaxis

LWSTDAPI IUnknown_GetWindow(
  [in]  IUnknown *punk,
  [out] HWND     *phwnd
);

Parámetros

[in] punk

Tipo: IUnknown*

Puntero al objeto COM desde el que esta función intentará obtener un identificador de ventana.

[out] phwnd

Tipo: HWND*

Puntero a un HWND que, cuando esta función vuelve correctamente, recibe el identificador de ventana. Si no se obtuvo un identificador de ventana, este parámetro se establece en NULL.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se devolvió correctamente un identificador de ventana o un código de error COM en caso contrario. Si no se encontró ninguna interfaz adecuada, la función devuelve E_NOINTERFACE. De lo contrario, la función devuelve el VALOR HRESULT devuelto por el método GetWindow de la interfaz correspondiente.

Comentarios

Esta función intenta recuperar el identificador de ventana mediante una llamada a IOleWindow::GetWindow, IInternetSecurityMgrSite::GetWindow e IShellView::GetWindow. Es posible que las versiones futuras de IUnknown_GetWindow intenten interfaces adicionales.

Nota La consulta de IShellView es teóricamente innecesaria porque IShellView deriva de IOleWindow. La función consulta explícitamente esta interfaz porque algunos objetos implementan QueryInterface incorrectamente y no responden a una consulta para la interfaz base.

 

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server, Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlwapi.h
Archivo DLL	Shlwapi.dll (versión 5.0 o posterior)