IShellWindows::RegisterPending, méthode (exdisp.h)

Article
08/23/2023

Inscrit une fenêtre en attente en tant que fenêtre Shell ; la fenêtre est spécifiée par un PIDL absolu.

Syntaxe

HRESULT RegisterPending(
        long    lThreadId,
  [in]  VARIANT *pvarloc,
  [in]  VARIANT *pvarlocRoot,
  [in]  int     swClass,
  [out] long    *plCookie
);

Paramètres

lThreadId

ID de thread.

[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 à inscrire.

[in] pvarlocRoot

Type : VARIANT*

Doit être NULL ou de type VT_EMPTY.

[in] swClass

Type : int

Membre de ShellWindowTypeConstants qui spécifie le type de fenêtre.

[out] plCookie

Type : long*

Cookie de la fenêtre.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Dans le contexte de la collection de fenêtres Shell, un cookie est un jeton qui identifie de manière unique une fenêtre Shell inscrite.

Utilisez cette méthode pour inscrire une fenêtre en attente d’ouverture ; si la fenêtre est déjà ouverte, utilisez plutôt IShellWindows::Register . Utilisez IShellWindows::Revoke pour annuler l’inscription d’une fenêtre.