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

  • Artigo

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)

Confira também

IApplicationActivationManager

IPackageDebugSettings::EnableDebugging