função IUnknown_GetWindow (shlwapi.h)

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.

Requisitos