ICLRRuntimeHost::ExecuteApplication, méthode

Article
05/10/2023

Utilisée dans les scénarios de déploiement ClickOnce basés sur le 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.

Syntaxe

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 contenant des chemins de manifeste pour l’application.

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

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

pReturnValue
[out] Valeur retournée par le point d’entrée de l’application.

Valeur de retour

HRESULT	Description
S_OK	`ExecuteApplication` retourné.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
HOST_E_TIMEOUT	L’appel a expiré.
HOST_E_NOT_OWNER	L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL	Une défaillance catastrophique inconnue s’est produite. Lorsqu’une méthode renvoie E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.

Notes

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

Le paramètre de sortie pReturnValue est défini avec 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.

Important

N’appelez pas la méthode Start 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 de méthode ExecuteApplication échoue.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

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

Versions de .NET Framework : Disponible depuis la version 2.0

Partager via