Compartilhar via


Método de ICLRRuntimeHost::ExecuteApplication

Usado em cenários de implantação ClickOnce baseada em manifesto para especificar o aplicativo a ser ativada em um novo domínio. Para obter mais informações sobre esses cenários, consulte ClickOnce Segurança e implantação.

HRESULT ExecuteApplication(
    [in] LPCWSTR   pwzAppFullName,
    [in] DWORD     dwManifestPaths,
    [in] LPCWSTR   *ppwzManifestPaths,
    [in] DWORD     dwActivationData,
    [in] LPCWSTR   *ppwzActivationData,
    [out] int      *pReturnValue
);

Parâmetros

  • pwzAppFullName
    [in] O nome completo do aplicativo, conforme definido para ApplicationIdentity.

  • dwManifestPaths
    [in] O número de cadeias de caracteres contidas no ppwzManifestPaths matriz.

  • ppwzManifestPaths
    [in] Opcional. Uma matriz de cadeia de caracteres que contém os caminhos do manifesto do aplicativo.

  • dwActivationData
    [in] O número de cadeias de caracteres contidas no ppwzActivationData matriz.

  • ppwzActivationData
    [in] Opcional. Uma matriz de cadeia de caracteres que contém os dados de ativação do aplicativo, como, por exemplo, a parte da seqüência de caracteres de consulta da URL para aplicativos implantados pela Web.

  • pReturnValue
    [out] O valor retornado a partir do ponto de entrada do aplicativo.

Valor de retorno

HRESULT

Descrição

S_OK

ExecuteApplicationretornado com êxito.

HOST_E_CLRNOTAVAILABLE

O common language runtime (CLR) não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.

HOST_E_TIMEOUT

A chamada foi esgotado.

HOST_E_NOT_OWNER

O chamador não possui o bloqueio.

HOST_E_ABANDONED

Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.

E_FAIL

Ocorreu uma falha catastrófica desconhecida. Se um método retornar E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

ExecuteApplicationé usado para ativar aplicativos de ClickOnce em um domínio de aplicativo recém-criado.

O pReturnValue o parâmetro de saída é definido como o valor retornado pelo aplicativo. Se você fornecer um valor nulo para pReturnValue, ExecuteApplication não falhe, mas não retornar um valor.

Observação importanteImportante

Não chame o Método de ICLRRuntimeHost::Start método antes de chamar o ExecuteApplication método para ativar um aplicativo baseado no manifesto.Se a Start método é chamado pela primeira vez, o ExecuteApplication chamada de método irá falhar.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso em mscoree

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Tarefas

Walkthrough: Fazer o download de Assemblies por demanda com a API usando o Designer de implantação de ClickOnce

Referência

ActivationContext

AppDomainManager

ApplicationIdentity

Interface de ICLRRuntimeHost

Método de IHostControl::SetAppDomainManager

Conceitos

Visão geral de hospedagem.