Метод 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)

См. также раздел

IApplicationActivationManager

IPackageDebugSettings::EnableDebugging