ICorRuntimeHost

Mise à jour : novembre 2007

Fournit des méthodes qui permettent à l'hôte de démarrer et d'arrêter explicitement le Common Language Runtime (CLR), de créer et configurer des domaines d'application, d'accéder au domaine par défaut et d'énumérer tous les domaines en cours d'exécution dans le processus.

Dans le .NET Framework version 2.0, cette interface est remplacée par ICLRRuntimeHost.

interface ICorRuntimeHost : IUnknown { 
    HRESULT CloseEnum (
        [in] HCORENUM hEnum
    );
    HRESULT CreateDomain (
        [in] LPWSTR pwzFriendlyName,
        [in] IUnknown* pIdentityArray, 
        [out] void ** pAppDomain
    );
    HRESULT CreateDomainEx (
        [in] LPCWSTR pwzFriendlyName, 
        [in] IUnknown* pSetup, 
        [in] IUnknown* pEvidence, 
        [out] IUnknown** pAppDomain
    );
    HRESULT CreateDomainSetup (
        [out] IUnknown** pAppDomainSetup
    );
    HRESULT CreateEvidence (
        [out] IUnknown** pEvidence
    );
    HRESULT CreateLogicalThreadState();
    HRESULT CurrentDomain (
        [out] IUnknown** pAppDomain
    );
    HRESULT DeleteLogicalThreadState();
    HRESULT EnumDomains (
        [out] HCORENUM *hEnum
    );
        HRESULT GetConfiguration(
            [out] ICorConfiguration** pConfiguration
        );
    HRESULT GetDefaultDomain (
        [out] IUnknown** pAppDomain
    );
    HRESULT LocksHeldByLogicalThread(
             [out] DWORD *pCount 
        );
    HRESULT NextDomain (
        [in] HCORENUM hEnum,
        [out] void** pAppDomain
    );
    HRESULT Start ();
    HRESULT Stop ();
    HRESULT SwitchInLogicalThreadState(
             [in] DWORD *pFiberCookie);
    HRESULT SwitchOutLogicalThreadState(
             [out] DWORD **pFiberCookie);
    HRESULT UnloadDomain (
        [in] IUnknown* pAppDomain
    ); 
}

Méthodes

Méthode	Description
ICorRuntimeHost::CloseEnum, méthode	Réinitialise un énumérateur de domaine au début de la liste de domaine.
ICorRuntimeHost::CreateDomain, méthode	Crée un domaine d'application. L'appelant reçoit un pointeur d'interface, de type _AppDomain, vers une instance de type System.AppDomain.
ICorRuntimeHost::CreateDomainEx, méthode	Crée un domaine d'application. Cette méthode permet à l'appelant de passer une instance IAppDomainSetup pour configurer davantage de fonctions de l'instance _AppDomain retournée.
ICorRuntimeHost::CreateDomainSetup, méthode	Obtient un pointeur d'interface, de type IAppDomainSetup, désignant une instance AppDomainSetup. IAppDomainSetup fournit des méthodes pour configurer des aspects d'un domaine d'application avant qu'il ne soit créé.
ICorRuntimeHost::CreateEvidence, méthode	Obtient un pointeur d'interface de type IIdentity qui permet à l'hôte de créer la preuve de sécurité à passer à CreateDomain ou CreateDomainEx.
ICorRuntimeHost::CreateLogicalThreadState, méthode	Ne pas utiliser.
ICorRuntimeHost::CurrentDomain, méthode	Obtient un pointeur d'interface de type _AppDomain qui représente le domaine chargé sur le thread actuel.
ICorRuntimeHost::DeleteLogicalThreadState, méthode	Ne pas utiliser.
ICorRuntimeHost::EnumDomains, méthode	Obtient un énumérateur pour les domaines dans le processus en cours.
ICorRuntimeHost::GetConfiguration, méthode	Obtient un objet qui permet à l'hôte de spécifier la configuration de rappel du CLR.
ICorRuntimeHost::GetDefaultDomain, méthode	Obtient un pointeur d'interface de type _AppDomain qui représente le domaine par défaut pour le processus en cours.
ICorRuntimeHost::LocksHeldByLogicalThread, méthode	Ne pas utiliser.
ICorRuntimeHost::MapFile, méthode	Mappe le fichier spécifié en mémoire. Cette méthode est obsolète.
ICorRuntimeHost::NextDomain, méthode	Obtient un pointeur d'interface au domaine suivant dans l'énumération.
ICorRuntimeHost::Start, méthode	Démarre le CLR.
ICorRuntimeHost::Stop, méthode	Arrête l'exécution du code dans le runtime pour le processus en cours.
ICorRuntimeHost::SwitchInLogicalThreadState, méthode	Ne pas utiliser.
ICorRuntimeHost::SwitchOutLogicalThreadState, méthode	Ne pas utiliser.
ICorRuntimeHost::UnloadDomain, méthode	Décharge le domaine d'application à partir du processus en cours.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.idl

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

Versions du .NET Framework : 1.0, 1.1

Voir aussi

Concepts

Hôtes de runtime

Référence

AppDomain

IAppDomainSetup

ICLRRuntimeHost

Autres ressources

Hébergement du Common Language Runtime

Interfaces d'hébergement