IApplicationActivationManager::ActivateApplication-Methode (shobjidl_core.h)

  • Artikel

Aktiviert die angegebene Windows Store-App für den generischen Startvertrag (Windows.Launch) in der aktuellen Sitzung.

Syntax

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

Parameter

[in] appUserModelId

Die Anwendungsbenutzermodell-ID der Windows Store-App.

[in] arguments

Ein Zeiger auf eine optionale, app-spezifische Argumentzeichenfolge.

[in] options

Eines oder mehrere der folgenden Flags, die zur Unterstützung des Entwurfsmodus, des Debuggens und von Testszenarien verwendet werden.

AO_NONE (0x00000000)

Es sind keine Flags festgelegt.

AO_DESIGNMODE (0x00000001)

Die App wird für den Entwurfsmodus aktiviert, sodass sie ihr normales Fenster nicht erstellen kann. Die Erstellung des App-Fensters muss durch Designtools erfolgen, die die erforderlichen Komponenten laden, indem sie mit einem vom Designer angegebenen Dienst in der Websitekette kommunizieren, die über den Aktivierungs-Manager eingerichtet wurde. Beachten Sie, dass dies bedeutet, dass der Begrüßungsbildschirm, der bei regulären Aktivierungen angezeigt wird, nicht angezeigt wird.

Beachten Sie, dass Sie den Debugmodus für das App-Paket aktivieren müssen, um den Entwurfsmodus erfolgreich verwenden zu können.

AO_NOERRORUI (0x00000002)

Kein Fehlerdialogfeld anzeigen, wenn die App nicht aktiviert werden kann.

AO_NOSPLASHSCREEN (0x00000004)

Zeigen Sie den Begrüßungsbildschirm der App nicht an, wenn die App aktiviert wird. Sie müssen den Debugmodus für das App-Paket aktivieren, wenn Sie dieses Flag verwenden. Andernfalls beendet plm die App nach einigen Sekunden.

AO_PRELAUNCH (0x2000000)

Die Anwendung wird im Vorabstartmodus aktiviert. Dieser Wert wird ab Windows 10 unterstützt.

[out] processId

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Methode die Prozess-ID der App instance empfängt, die diesen Vertrag erfüllt.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)

Weitere Informationen

IApplicationActivationManager

IPackageDebugSettings::EnableDebugging