Método ICLRRuntimeHost::ExecuteApplication
Usado em cenários de implantação ClickOnce baseados em manifesto para especificar o aplicativo a ser ativado em um novo domínio. Para obter mais informações sobre esses cenários, consulte Segurança e implantação do ClickOnce.
Sintaxe
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 na matriz ppwzManifestPaths.
ppwzManifestPaths
[in] Opcional. Uma matriz de cadeia de caracteres que contém caminhos do manifesto do aplicativo.
dwActivationData
[in] O número de cadeias de caracteres contidas na matriz ppwzActivationData.
ppwzActivationData
[in] Opcional. Uma matriz de cadeia de caracteres que contém os dados de ativação do aplicativo, como a parte da cadeia de caracteres de consulta da URL para aplicativos implantados na Web.
pReturnValue
[out] O valor retornado a partir do ponto de entrada do aplicativo.
Valor Retornado
| HRESULT | Descrição |
|---|---|
| S_OK | ExecuteApplication retornado com êxito. |
| HOST_E_CLRNOTAVAILABLE | O CLR (Common Language Runtime) não foi carregado em um processo ou está em um estado no qual não pode executar o código gerenciado ou processar a chamada com sucesso. |
| HOST_E_TIMEOUT | Uma chamada atingiu o tempo limite. |
| HOST_E_NOT_OWNER | O chamador não possui o bloqueio. |
| HOST_E_ABANDONED | Um evento foi cancelado enquanto uma fibra ou um thread bloqueado estava esperando por ele. |
| E_FAIL | Uma falha catastrófica desconhecida ocorreu. Se um método retornar E_FAIL, o CLR não poderá mais ser utilizado no processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE. |
Comentários
ExecuteApplication é usado para ativar aplicativos ClickOnce em um domínio de aplicativo criado recentemente.
O parâmetro de saída pReturnValue é definido como o valor retornado pelo aplicativo. Se você fornecer um valor nulo para pReturnValue, ExecuteApplication não falhará, mas ele não retornará um valor.
Importante
Não chame o método Método Start antes de chamar o método ExecuteApplication para ativar um aplicativo baseado em manifesto. Se o método Start for chamado primeiro, a chamada do método ExecuteApplication falhará.
Requisitos
Plataformas: confira Requisitos do sistema.
Cabeçalho: MSCorEE.h
Biblioteca: incluída como um recurso no MSCorEE.dll
Versões do .NET Framework: disponíveis desde 2.0
