Méthode IShellWindows::FindWindowSW (exdisp.h)

Article
08/23/2023

Recherche une fenêtre dans la collection De fenêtres Shell et retourne le handle et l’interface IDispatch de la fenêtre.

Syntaxe

HRESULT FindWindowSW(
  [in]          VARIANT   *pvarLoc,
  [in]          VARIANT   *pvarLocRoot,
  [in]          int       swClass,
  [out]         long      *phwnd,
                int       swfwOptions,
  [out, retval] IDispatch **ppdispOut
);

Paramètres

[in] pvarLoc

Type : VARIANT*

Variant de type VT_VARIANT | VT_BYREF. Définissez la valeur de pvarLoc sur un PIDL absolu (PIDLIST_ABSOLUTE) qui spécifie la fenêtre à rechercher. (Voir remarques.)

[in] pvarLocRoot

Type : VARIANT*

Doit être NULL ou de type VT_EMPTY.

[in] swClass

Type : int

Un ou plusieurs indicateurs ShellWindowTypeConstants qui spécifient les types de fenêtres à inclure dans la recherche.

[out] phwnd

Type : long*

Handle pour la fenêtre correspondant aux critères de recherche spécifiés, ou NULL si aucune fenêtre de ce type n’a été trouvée.

swfwOptions

Type : int

Un ou plusieurs indicateurs ShellWindowFindWindowOptions qui spécifient des options de recherche.

[out, retval] ppdispOut

Type : IDispatch**

Référence à l’interface IDispatch de la fenêtre, ou NULL si aucune fenêtre de ce type n’a été trouvée.

Valeur retournée

Type : HRESULT

L’une des valeurs suivantes, ou un code de résultat standard.

Code de retour	Description
S_OK	Une fenêtre correspondant aux critères de recherche spécifiés a été trouvée.
S_FALSE	Une fenêtre correspondant aux critères de recherche spécifiés est introuvable.
E_NOINTERFACE	Une fenêtre a été trouvée, mais une référence à l’interface IDispatch de la fenêtre n’a pas pu être obtenue. Se produit uniquement si l’indicateur SWFO_NEEDDISPATCH est défini.
E_PENDING	Une fenêtre a été trouvée, mais la fenêtre est en attente d’ouverture. Se produit uniquement si l’indicateur SWFO_INCLUDEPENDING est défini.

Notes

Si l’indicateur SWFO_COOKIEPASSED est défini, pvarLoc est interprété comme un cookie au lieu d’un PIDL.

Spécifications


Plateforme cible	Windows
En-tête	exdisp.h
DLL	Shdocvw.dll (version 5.00.2014.0216 ou ultérieure)

Partager via