ICLRRuntimeHost::ExecuteApplication 方法

在基于清单的 ClickOnce 部署方案中用于指定要在新域中激活的应用程序。 有关这些方案的更多信息,请参见 ClickOnce 安全和部署

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

参数

  • pwzAppFullName
    [in] 应用程序的全名,正如为 ApplicationIdentity 定义的那样。

  • dwManifestPaths
    [in] ppwzManifestPaths 数组中包含的字符串数目。

  • ppwzManifestPaths
    [in] 可选。 包含应用程序的清单路径的字符串数组。

  • dwActivationData
    [in] ppwzActivationData 数组中包含的字符串数目。

  • ppwzActivationData
    [in] 可选。 包含应用程序激活数据(如,对于部署在 Web 上的应用程序来说,是 URL 的查询字符串部分)的字符串数组。

  • pReturnValue
    [out] 从应用程序入口点返回的值。

返回值

HRESULT

说明

S_OK

ExecuteApplication 已成功返回。

HOST_E_CLRNOTAVAILABLE

公共语言运行时 (CLR) 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。

HOST_E_TIMEOUT

调用超时。

HOST_E_NOT_OWNER

调用方不拥有锁。

HOST_E_ABANDONED

事件在被阻止的线程或纤程正在等待它时被取消。

E_FAIL

发生了未知的灾难性故障。 如果某方法返回 E_FAIL,CLR 便无法再在进程中使用。 对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。

备注

ExecuteApplication 用于在新建的应用程序域中激活 ClickOnce 应用程序。

将 pReturnValue 输出参数设置为应用程序返回的值。 当为 pReturnValue 提供的值为 Null 时,虽然 ExecuteApplication 不会失败,但它不会返回任何值。

重要说明重要事项

在调用 ExecuteApplication 方法来激活基于清单的应用程序之前,不要调用 ICLRRuntimeHost::Start 方法 方法。如果首先调用 Start 方法,则 ExecuteApplication 方法调用将失败。

要求

**平台:**请参见 .NET Framework 系统要求

**头文件:**MSCorEE.h

**库:**作为一项资源包含在 MSCorEE.dll 中

**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

请参见

任务

演练:在设计器中使用 ClickOnce 部署 API 按需下载程序集

参考

ActivationContext

AppDomainManager

ApplicationIdentity

ICLRRuntimeHost 接口

IHostControl::SetAppDomainManager 方法

概念

承载概述