funzione IUnknown_GetWindow (shlwapi.h)

Tenta di recuperare un handle di finestra da un oggetto COM (Component Object Model) eseguendo una query per diverse interfacce che dispongono di un metodo GetWindow .

Sintassi

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

Parametri

[in] punk

Tipo: IUnknown*

Puntatore all'oggetto COM da cui questa funzione tenterà di ottenere un handle di finestra.

[out] phwnd

Tipo: HWND*

Puntatore a un HWND che, quando questa funzione viene restituita correttamente, riceve l'handle della finestra. Se non è stato ottenuto un handle di finestra, questo parametro viene impostato su NULL.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se un handle di finestra è stato restituito correttamente oppure un codice di errore COM in caso contrario. Se non è stata trovata alcuna interfaccia appropriata, la funzione restituisce E_NOINTERFACE. In caso contrario, la funzione restituisce il valore HRESULT restituito dal metodo GetWindow dell'interfaccia corrispondente.

Commenti

Questa funzione tenta di recuperare l'handle della finestra chiamando IOleWindow::GetWindow, IInternetSecurityMgrSite::GetWindow e IShellView::GetWindow. È possibile che le versioni future di IUnknown_GetWindow possano tentare interfacce aggiuntive.

Requisiti