ICorRuntimeHost

Articolo
09/12/2008

Aggiornamento: novembre 2007

Fornisce metodi che consentono all'host di avviare e interrompere esplicitamente Common Language Runtime, creare e configurare domini applicazione, accedere al dominio predefinito ed enumerare tutti i domini in esecuzione nel processo.

In .NET Framework versione 2.0, questa interfaccia è stata sostituita da 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
    ); 
}

Metodi

Metodo	Descrizione
Metodo ICorRuntimeHost::CloseEnum	Reimposta un enumeratore di domini sull'inizio dell'elenco dei domini.
Metodo ICorRuntimeHost::CreateDomain	Crea un dominio applicazione. Il chiamante riceve un puntatore a interfaccia di tipo _AppDomain a un'istanza di tipo System.AppDomain.
Metodo ICorRuntimeHost::CreateDomainEx	Crea un dominio applicazione. Questo metodo consente al chiamante di passare un'istanza di IAppDomainSetup per configurare funzionalità aggiuntive dell'istanza di _AppDomain restituita.
Metodo ICorRuntimeHost::CreateDomainSetup	Ottiene un puntatore a interfaccia di tipo IAppDomainSetup a un'istanza di AppDomainSetup. IAppDomainSetup fornisce metodi per la configurazione di aspetti di un dominio applicazione prima che venga creato.
Metodo ICorRuntimeHost::CreateEvidence	Ottiene un puntatore a interfaccia di tipo IIdentity che consente all'host di creare evidenze di sicurezza da passare a CreateDomain o a CreateDomainEx.
Metodo ICorRuntimeHost::CreateLogicalThreadState	Non utilizzare.
Metodo ICorRuntimeHost::CurrentDomain	Ottiene un puntatore a interfaccia di tipo _AppDomain che rappresenta il dominio caricato nel thread corrente.
Metodo ICorRuntimeHost::DeleteLogicalThreadState	Non utilizzare.
Metodo ICorRuntimeHost::EnumDomains	Ottiene un enumeratore per i domini nel processo corrente.
Metodo ICorRuntimeHost::GetConfiguration	Ottiene un oggetto che consente all'host di specificare la configurazione di callback di Common Language Runtime.
Metodo ICorRuntimeHost::GetDefaultDomain	Ottiene un puntatore a interfaccia di tipo _AppDomain che rappresenta il dominio predefinito per il processo corrente.
Metodo ICorRuntimeHost::LocksHeldByLogicalThread	Non utilizzare.
Metodo ICorRuntimeHost::MapFile	Esegue il mapping del file specificato in memoria. Questo metodo è obsoleto.
Metodo ICorRuntimeHost::NextDomain	Ottiene un puntatore a interfaccia al dominio successivo nell'enumerazione.
Metodo ICorRuntimeHost::Start	Avvia Common Language Runtime.
Metodo ICorRuntimeHost::Stop	Arresta l'esecuzione del codice nel runtime per il processo corrente.
Metodo ICorRuntimeHost::SwitchInLogicalThreadState	Non utilizzare.
Metodo ICorRuntimeHost::SwitchOutLogicalThreadState	Non utilizzare.
Metodo ICorRuntimeHost::UnloadDomain	Scarica il dominio applicazione specificato dal processo corrente.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.idl

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 1.0, 1.1

Vedere anche

Condividi tramite

ICorRuntimeHost

Metodi

Requisiti

Vedere anche

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive