IApplicationActivationManager::ActivateApplication-Methode (shobjidl_core.h)
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) |