ICLRRuntimeHost::ExecuteApplication (Método)

  • Artículo

Se usa en escenarios de implementación ClickOnce basados en manifiestos para especificar la aplicación que se va a activar en un nuevo dominio. Para obtener más información sobre estos escenarios, vea Seguridad e implementación ClickOnce.

Sintaxis

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

Parámetros

pwzAppFullName
[in] Nombre completo de la aplicación, tal como se define para ApplicationIdentity.

dwManifestPaths
[in] Número de cadenas incluidas en la matriz ppwzManifestPaths.

ppwzManifestPaths
[in] Opcional. Matriz de cadenas que contiene rutas de acceso de manifiesto para la aplicación.

dwActivationData
[in] Número de cadenas incluidas en la matriz ppwzActivationData.

ppwzActivationData
[in] Opcional. Matriz de cadenas que contiene los datos de activación de la aplicación como, por ejemplo, la parte de la cadena de consulta de la dirección URL para las aplicaciones implementadas en la web.

pReturnValue
[out] Valor devuelto del punto de entrada de la aplicación.

Valor devuelto

HRESULT Descripción
S_OK ExecuteApplication se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER El autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Si se devuelve este valor, significa que ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el motor CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.

Comentarios

ExecuteApplication se usa para activar las aplicaciones ClickOnce en un dominio de aplicación recién creado.

El parámetro de salida pReturnValue se establece en el valor que devuelve la aplicación. Si proporciona un valor null para pReturnValue, ExecuteApplication no produce un error, pero tampoco devuelve un valor.

Importante

No llame al método Start Method antes de llamar al método ExecuteApplication para activar una aplicación basada en manifiestos. Si se llama primero al método Start, se producirá un error en la llamada de método ExecuteApplication.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también