Поделиться через


Метод ICLRRuntimeHost::ExecuteApplication

Обновлен: Ноябрь 2007

Используется в сценарии развертывания на основе манифеста 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] Необязательно. Строковый массив, содержащий данные активации приложения, например часть строки запроса, соответствующую 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 выполняется без сбоя, однако не возвращает значение.

ms164409.alert_caution(ru-ru,VS.90).gifВажное примечание.

Для активации приложения на основе манифеста не следует вызывать метод Метод ICLRRuntimeHost::Start перед вызовом метода ExecuteApplication. Если сначала вызывается метод Start, при вызове метода ExecuteApplication происходит сбой.

Требования

Платформы: см. раздел Требования к системе для .NET Framework.

Заголовок: MSCorEE.idl

Библиотека: включена как ресурс в MSCorEE.dll

Версии платформы .NET Framework: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

См. также

Задачи

Пошаговое руководство. Загрузка сборок по требованию с помощью API развертывания ClickOnce с использованием конструктора

Ссылки

ActivationContext

AppDomainManager

ApplicationIdentity

Интерфейс ICLRRuntimeHost

Метод IHostControl::SetAppDomainManager

Другие ресурсы

Размещение среды CLR