função IUnknown_GetWindow (shlwapi.h)

  • Artigo

Tenta recuperar um identificador de janela de um objeto COM (Component Object Model) consultando várias interfaces que têm um método GetWindow .

Sintaxe

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

Parâmetros

[in] punk

Tipo: IUnknown*

Um ponteiro para o objeto COM do qual essa função tentará obter um identificador de janela.

[out] phwnd

Tipo: HWND*

Um ponteiro para um HWND que, quando essa função retorna com êxito, recebe o identificador de janela. Se um identificador de janela não tiver sido obtido, esse parâmetro será definido como NULL.

Retornar valor

Tipo: HRESULT

Retorna S_OK se um identificador de janela foi retornado com êxito ou um código de erro COM, caso contrário. Se nenhuma interface adequada for encontrada, a função retornará E_NOINTERFACE. Caso contrário, a função retorna o HRESULT retornado pelo método GetWindow da interface correspondente.

Comentários

Essa função tenta recuperar o identificador de janela chamando IOleWindow::GetWindow, IInternetSecurityMgrSite::GetWindow e IShellView::GetWindow. É possível que versões futuras do IUnknown_GetWindow possam tentar interfaces adicionais.

Nota A consulta para IShellView é teoricamente desnecessária porque IShellView deriva de IOleWindow. A função consulta explicitamente essa interface porque alguns objetos implementam QueryInterface incorretamente e não respondem a uma consulta para a interface base.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server, Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlwapi.h
DLL Shlwapi.dll (versão 5.0 ou posterior)