Método IApplicationActivationManager::ActivateApplication (shobjidl_core.h)
Ativa o aplicativo da Windows Store especificado para o contrato de inicialização genérico (Windows.Launch) na sessão atual.
Sintaxe
HRESULT ActivateApplication(
[in] LPCWSTR appUserModelId,
[in] LPCWSTR arguments,
[in] ACTIVATEOPTIONS options,
[out] DWORD *processId
);
Parâmetros
[in] appUserModelId
A ID do modelo de usuário do aplicativo da Windows Store.
[in] arguments
Um ponteiro para uma cadeia de caracteres de argumento opcional, específica do aplicativo.
[in] options
Um ou mais dos sinalizadores a seguir usados para dar suporte a cenários de modo de design, depuração e teste.
AO_NONE (0x00000000)
Nenhum sinalizador está definido.
AO_DESIGNMODE (0x00000001)
O aplicativo está sendo ativado para o modo de design, portanto, ele não pode criar sua janela normal. A criação da janela do aplicativo deve ser feita por ferramentas de design que carregam os componentes necessários comunicando-se com um serviço especificado pelo designer na cadeia de sites estabelecida por meio do gerenciador de ativação. Observe que isso significa que a tela inicial vista durante as ativações regulares não será vista.
Observe que você deve habilitar o modo de depuração no pacote do aplicativo para usar com êxito o modo de design.
AO_NOERRORUI (0x00000002)
Não exiba uma caixa de diálogo de erro se o aplicativo não for ativado.
AO_NOSPLASHSCREEN (0x00000004)
Não exiba a tela inicial do aplicativo quando o aplicativo estiver ativado. Você deve habilitar o modo de depuração no pacote do aplicativo ao usar esse sinalizador; caso contrário, o PLM encerrará o aplicativo após alguns segundos.
AO_PRELAUNCH (0x2000000)
O aplicativo está sendo ativado no modo de pré-inicialização. Esse valor tem suporte a partir de Windows 10.
[out] processId
Um ponteiro para um valor que, quando esse método retorna com êxito, recebe a ID do processo da instância do aplicativo que atende a esse contrato.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shobjidl_core.h (inclua Shobjidl.h) |