Méthode IHandlerActivationHost ::BeforeCoCreateInstance (shobjidl_core.h)

Avertit un client de ShellExecuteEx qu’un gestionnaire est sur le point d’être créé, ce qui lui donne la possibilité d’afficher l’interface utilisateur confirmant l’utilisation de ce gestionnaire ou de la rejeter en retournant un code d’erreur spécifique.

Syntaxe

HRESULT BeforeCoCreateInstance(
  [in] REFCLSID        clsidHandler,
  [in] IShellItemArray *itemsBeingActivated,
  [in] IHandlerInfo    *handlerInfo
);

Paramètres

[in] clsidHandler

Identifie le gestionnaire.

[in] itemsBeingActivated

Objets d’élément Shell qui seront transmis au gestionnaire. En général, il n’y en a qu’un, mais dans certains cas, il peut y en avoir plusieurs.

[in] handlerInfo

Fournit l’accès aux informations sur le gestionnaire qui sera appelé. Cet objet prend également en charge IHandlerInfo2 sur les versions de Windows qui prennent en charge cette interface.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT , HRESULT_FROM_WIN32(ERROR_CANCELLED) indique que l’appel ShellExecute doit être annulé, EXECUTE_E_LAUNCH_APPLICATION indique que ce gestionnaire ne doit pas être utilisé, mais s’il existe un autre, il doit être utilisé.

Configuration requise

Voir aussi

IHandlerActivationHost