Partager via


ICLRRuntimeHost::ExecuteApplication, méthode

Utilisé dans les scénarios de déploiement ClickOnce basés sur un manifeste pour spécifier l'application à activer dans un nouveau domaine. Pour plus d'informations sur ces scénarios, consultez Sécurité et déploiement ClickOnce.

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

Paramètres

  • pwzAppFullName
    [in] Nom complet de l'application, tel que défini pour ApplicationIdentity.

  • dwManifestPaths
    [in] Nombre de chaînes contenues dans le tableau ppwzManifestPaths.

  • ppwzManifestPaths
    [in] Facultatif. Tableau de chaînes qui contient des chemins d'accès de manifeste pour l'application.

  • dwActivationData
    [in] Nombre de chaînes contenues dans le tableau ppwzActivationData.

  • ppwzActivationData
    [in] Facultatif. Tableau de chaînes qui contient les données d'activation de l'application, telles que la partie de chaîne de requête de l'URL pour les applications déployées sur le Web.

  • pReturnValue
    [out] Valeur retournée à partir du point d'entrée de l'application.

Valeur de retour

HRESULT

Description

S_OK

ExecuteApplication a été retourné avec succès.

HOST_E_CLRNOTAVAILABLE

Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.

HOST_E_TIMEOUT

L'appel a expiré.

HOST_E_NOT_OWNER

L'appelant ne possède pas le verrou.

HOST_E_ABANDONED

Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.

E_FAIL

Une défaillance grave et inconnue s'est produite. Si une méthode retourne E_FAIL, le CLR n'est plus utilisable au sein du processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

Notes

ExecuteApplication est utilisé pour activer des applications ClickOnce dans un domaine d'application récemment créé.

Le paramètre de sortie pReturnValue est défini à la valeur retournée par l'application. Si vous fournissez une valeur null pour pReturnValue, ExecuteApplication n'échoue pas, mais aucune valeur n'est retournée.

Remarque importanteImportant

N'appelez pas la méthode ICLRRuntimeHost::Start, méthode avant d'appeler la méthode ExecuteApplication pour activer une application basée sur un manifeste.Si la méthode Start est appelée en premier, l'appel à la méthode ExecuteApplication échoue.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Tâches

Procédure pas à pas : téléchargement d'assemblys à la demande avec l'API du déploiement ClickOnce à l'aide du concepteur

Référence

ActivationContext

AppDomainManager

ApplicationIdentity

ICLRRuntimeHost, interface

IHostControl::SetAppDomainManager, méthode

Concepts

Vue d'ensemble de l'hébergement