IApplicationActivationManager ::ActivateApplication, méthode (shobjidl_core.h)

  • Article

Active l’application Windows Store spécifiée pour le contrat de lancement générique (Windows.Launch) dans la session active.

Syntaxe

HRESULT ActivateApplication(
  [in]  LPCWSTR         appUserModelId,
  [in]  LPCWSTR         arguments,
  [in]  ACTIVATEOPTIONS options,
  [out] DWORD           *processId
);

Paramètres

[in] appUserModelId

ID de modèle utilisateur de l’application du Windows Store.

[in] arguments

Pointeur vers une chaîne d’argument facultative spécifique à l’application.

[in] options

Un ou plusieurs des indicateurs suivants sont utilisés pour prendre en charge les scénarios de test, de débogage et de mode conception.

AO_NONE (0x00000000)

Aucun indicateur n'est défini.

AO_DESIGNMODE (0x00000001)

L’application étant activée pour le mode création, elle ne peut pas créer sa fenêtre normale. La création de la fenêtre de l’application doit être effectuée par des outils de conception qui chargent les composants nécessaires en communiquant avec un service spécifié par le concepteur sur la chaîne de site établie via le gestionnaire d’activation. Notez que cela signifie que l’écran de démarrage affiché pendant les activations régulières ne sera pas visible.

Notez que vous devez activer le mode débogage sur le package de l’application pour utiliser correctement le mode Création.

AO_NOERRORUI (0x00000002)

N’affichez pas de boîte de dialogue d’erreur si l’application ne parvient pas à s’activer.

AO_NOSPLASHSCREEN (0x00000004)

N’affichez pas l’écran de démarrage de l’application lorsque l’application est activée. Vous devez activer le mode débogage sur le package de l’application lorsque vous utilisez cet indicateur ; sinon, le PLM arrêtera l’application après quelques secondes.

AO_PRELAUNCH (0x2000000)

L’application est activée en mode prélancement. Cette valeur est prise en charge à partir de Windows 10.

[out] processId

Pointeur vers une valeur qui, lorsque cette méthode retourne correctement, reçoit l’ID de processus de l’application instance qui remplit ce contrat.

Valeur retournée

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

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)

Voir aussi

IApplicationActivationManager

IPackageDebugSettings ::EnableDebugging