IUnknown_GetWindow, fonction (shlwapi.h)

Article
03/02/2024

Tente de récupérer un handle de fenêtre à partir d’un objet COM (Component Object Model) en interrogeant diverses interfaces qui ont une méthode GetWindow .

Syntaxe

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

Paramètres

[in] punk

Type : IUnknown*

Pointeur vers l’objet COM à partir duquel cette fonction tente d’obtenir un handle de fenêtre.

[out] phwnd

Type : HWND*

Pointeur vers un HWND qui, lorsque cette fonction retourne correctement, reçoit le handle de fenêtre. Si aucun handle de fenêtre n’a été obtenu, ce paramètre a la valeur NULL.

Valeur retournée

Type : HRESULT

Retourne S_OK si un handle de fenêtre a été correctement retourné, ou un code d’erreur COM dans le cas contraire. Si aucune interface appropriée n’a été trouvée, la fonction retourne E_NOINTERFACE. Sinon, la fonction retourne le HRESULT retourné par la méthode GetWindow de l’interface correspondante.

Remarques

Cette fonction tente de récupérer le handle de fenêtre en appelant IOleWindow ::GetWindow, IInternetSecurityMgrSite ::GetWindow et IShellView ::GetWindow. Il est possible que les versions ultérieures de IUnknown_GetWindow tentent d’autres interfaces.

Note La requête pour IShellView est théoriquement inutile, car IShellView dérive de IOleWindow. La fonction interroge explicitement cette interface, car certains objets implémentent QueryInterface de manière incorrecte et ne répondent pas à une requête pour l’interface de base.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server, Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Partager via