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


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

Важное примечаниеВажно

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

Требования

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

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

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

Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0

См. также

Задачи

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

Ссылки

ActivationContext

AppDomainManager

ApplicationIdentity

Интерфейс ICLRRuntimeHost

Метод IHostControl::SetAppDomainManager

Основные понятия

Общие сведения о размещении