ICLRRuntimeHost

Article
08/22/2008

Mise à jour : novembre 2007

Fournit des fonctionnalités similaires à celles de l'interface ICorRuntimeHost proposée dans la version 1 du .NET Framework, avec les changements suivants :

l'ajout de la méthode SetHostControl pour définir l'interface de contrôle de l'hôte ;
l'omission de certaines méthodes fournies par ICorRuntimeHost.

interface ICLRRuntimeHost : IUnknown {
        
    HRESULT ExecuteApplication (
        [in] LPCWSTR                   pwzAppFullName,
        [in] DWORD                     dwManifestPaths,
        [in] LPCWSTR                   *ppwzManifestPaths,   
        [in] DWORD                     dwActivationData,
        [in] LPCWSTR                   *ppwzActivationData,  
        [out] int                      *pReturnValue
    );
        
    HRESULT ExecuteInAppDomain (
        [in] DWORD                     appDomainId, 
        [in] FExecuteInDomainCallback  pCallback,
        [in] void*                     cookie
    );
        
    HRESULT ExecuteInDefaultAppDomain (
        [in] LPCWSTR                   pwzAssemblyPath, 
        [in] LPCWSTR                   pwzTypeName,
        [in] LPCWSTR                   pwzMethodName,
        [in] LPCWSTR                   pwzArgument,
        [out] DWORD                    *pReturnValue
    );
        
    HRESULT GetCLRControl (
        [out] ICLRControl              **pCLRControl
    );
        
    HRESULT GetCurrentAppDomainId (
        [out] DWORD                    *pdwAppDomainId
    );
        
    HRESULT SetHostControl (
        [in] IHostControl              *pHostControl
    );
        
    HRESULT Start();
        
    HRESULT Stop();
        
    HRESULT UnloadAppDomain (
        [in] DWORD                     dwAppDomainId
        [in] BOOL                      fWaitUntilDone
    );
        
};

Méthodes

Méthode	Description
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.
ICLRRuntimeHost::ExecuteInAppDomain, méthode	Spécifie le AppDomain dans lequel exécuter le code managé spécifié.
ICLRRuntimeHost::ExecuteInDefaultAppDomain, méthode	Appelle la méthode spécifiée du type spécifié dans l'assembly spécifié.
ICLRRuntimeHost::GetCLRControl, méthode	Obtient un pointeur d'interface de type ICLRControl que les hôtes peuvent utiliser pour personnaliser des aspects du Common Language Runtime (CLR).
ICLRRuntimeHost::GetCurrentAppDomainId, méthode	Obtient l'identificateur numérique du AppDomain en cours d'exécution.
ICLRRuntimeHost::SetHostControl, méthode	Définit l'interface de contrôle de l'hôte. Vous devez appeler SetHostControl avant d'appeler Start.
ICLRRuntimeHost::Start, méthode	Initialise le CLR dans un processus.
ICLRRuntimeHost::Stop, méthode	Arrête l'exécution du code par le runtime.
ICLRRuntimeHost::UnloadAppDomain, méthode	Décharge le AppDomain qui correspond à l'identificateur numérique spécifié.

Notes

L'hôte obtient un pointeur vers une instance ICLRRuntimeHost en appelant CorBindToRuntimeEx ou CorBindToCurrentRuntime. Pour fournir des implémentations de chacune des technologies fournies dans le .NET Framework version 2.0, vous devez utiliser ICLRRuntimeHost à la place de ICorRuntimeHost.

Remarque importante :
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 à la méthode ExecuteApplication échoue.