Método ICLRRuntimeHost::ExecuteApplication

Artigo
05/10/2023

Utilizado em cenários de implementação ClickOnce baseados em manifestos para especificar a aplicação a ser ativada num novo domínio. Para obter mais informações sobre estes cenários, veja ClickOnce Security and Deployment (Segurança e Implementaçã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 da aplicação, conforme definido para ApplicationIdentity.

dwManifestPaths
[in] O número de cadeias contidas na ppwzManifestPaths matriz.

ppwzManifestPaths
[in] Opcional. Uma matriz de cadeia que contém caminhos de manifesto para a aplicação.

dwActivationData
[in] O número de cadeias contidas na ppwzActivationData matriz.

ppwzActivationData
[in] Opcional. Uma matriz de cadeia que contém os dados de ativação da aplicação, como a parte da cadeia de consulta do URL para aplicações implementadas na Web.

pReturnValue
[fora] O valor devolvido a partir do ponto de entrada da aplicação.

Devolver Valor

HRESULT	Description
S_OK	`ExecuteApplication` devolvido com êxito.
HOST_E_CLRNOTAVAILABLE	O runtime de linguagem comum (CLR) não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada excedeu o limite de tempo.
HOST_E_NOT_OWNER	O autor da chamada não é o proprietário do bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera do mesmo.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Se um método devolver E_FAIL, o CLR deixará de ser utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE.

Observações

ExecuteApplication é utilizado para ativar aplicações ClickOnce num domínio de aplicação recentemente criado.

O pReturnValue parâmetro de saída está definido para o valor devolvido pela aplicação. Se fornecer um valor nulo para pReturnValue, ExecuteApplication não falha, mas não devolve um valor.

Importante

Não chame o método Método Iniciar antes de chamar o ExecuteApplication método para ativar uma aplicação baseada em manifestos. Se o Start método for chamado primeiro, a chamada do ExecuteApplication método falhará.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

.NET Framework Versões: Disponível desde 2.0

Partilhar via