Метод IApplicationActivationManager::ActivateApplication (shobjidl_core.h)
Активирует указанное приложение Магазина Windows для универсального контракта запуска (Windows.Launch) в текущем сеансе.
Синтаксис
HRESULT ActivateApplication(
[in] LPCWSTR appUserModelId,
[in] LPCWSTR arguments,
[in] ACTIVATEOPTIONS options,
[out] DWORD *processId
);
Параметры
[in] appUserModelId
Идентификатор модели пользователя приложения Магазина Windows.
[in] arguments
Указатель на необязательную строку аргумента для конкретного приложения.
[in] options
Один или несколько из следующих флагов, используемых для поддержки режима разработки, отладки и тестирования сценариев.
AO_NONE (0x00000000)
Флаги не установлены.
AO_DESIGNMODE (0x00000001)
Приложение активируется в режиме конструктора, поэтому оно не может создать свое обычное окно. Создание окна приложения должно выполняться средствами проектирования, которые загружают необходимые компоненты, взаимодействуя с указанной конструктором службой в цепочке сайтов, созданной через диспетчер активации. Обратите внимание, что это означает, что экран-заставка, видимый во время обычных активаций, не будет виден.
Обратите внимание, что для успешного использования режима конструктора в пакете приложения необходимо включить режим отладки .
AO_NOERRORUI (0x00000002)
Если не удается активировать приложение, диалоговое окно ошибки не отображается.
AO_NOSPLASHSCREEN (0x00000004)
Не отображать экран-заставку приложения при активации приложения. При использовании этого флага необходимо включить режим отладки в пакете приложения; В противном случае PLM завершит работу приложения через несколько секунд.
AO_PRELAUNCH (0x2000000)
Приложение активируется в режиме предварительного запуска. Это значение поддерживается начиная с Windows 10.
[out] processId
Указатель на значение, которое при успешном возврате этого метода получает идентификатор процесса экземпляра приложения, выполняющего этот контракт.
Возвращаемое значение
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shobjidl_core.h (включая Shobjidl.h) |