Método IApplicationActivationManager::ActivateApplication (shobjidl_core.h)

Activa la aplicación de la Tienda Windows especificada para el contrato de inicio genérico (Windows.Launch) en la sesión actual.

Sintaxis

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

Parámetros

[in] appUserModelId

Identificador del modelo de usuario de la aplicación de la Tienda Windows.

[in] arguments

Puntero a una cadena de argumentos opcional específica de la aplicación.

[in] options

Una o varias de las marcas siguientes que se usan para admitir escenarios de modo de diseño, depuración y pruebas.

AO_NONE (0x00000000)

No se establecen marcas.

AO_DESIGNMODE (0x00000001)

La aplicación se está activando para el modo de diseño, por lo que no puede crear su ventana normal. La creación de la ventana de la aplicación debe realizarse mediante herramientas de diseño que cargan los componentes necesarios mediante la comunicación con un servicio especificado por el diseñador en la cadena de sitio establecida a través del administrador de activación. Tenga en cuenta que esto significa que la pantalla de presentación que se ve durante las activaciones regulares no se verá.

Ten en cuenta que debes habilitar el modo de depuración en el paquete de la aplicación para usar correctamente el modo de diseño.

AO_NOERRORUI (0x00000002)

No muestre un cuadro de diálogo de error si la aplicación no se puede activar.

AO_NOSPLASHSCREEN (0x00000004)

No muestre la pantalla de presentación de la aplicación cuando se active la aplicación. Debe habilitar el modo de depuración en el paquete de la aplicación cuando use esta marca; de lo contrario, el PLM finalizará la aplicación después de unos segundos.

AO_PRELAUNCH (0x2000000)

La aplicación se está activando en modo de inicio previo. Este valor se admite a partir de Windows 10.

[out] processId

Puntero a un valor que, cuando este método devuelve correctamente, recibe el identificador de proceso de la instancia de la aplicación que cumple este contrato.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)

Consulte también

IApplicationActivationManager

IPackageDebugSettings::EnableDebugging