ICorRuntimeHost

Aktualisiert: November 2007

Stellt Methoden bereit, mit denen der Host die Common Language Runtime (CLR) explizit starten und beenden, Anwendungsdomänen erstellen und konfigurieren, auf die Standarddomäne zugreifen und sämtliche im Prozess ausgeführten Domänen auflisten kann.

In .NET Framework, Version 2.0, wird diese Schnittstelle durch ICLRRuntimeHost ersetzt.

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
    ); 
}

Methoden

Methode	Beschreibung
ICorRuntimeHost::CloseEnum-Methode	Setzt einen Domänenenumerator an den Anfang der Domänenliste zurück.
ICorRuntimeHost::CreateDomain-Methode	Erstellt eine Anwendungsdomäne. Der Aufrufer empfängt einen Schnittstellenzeiger vom Typ _AppDomain auf eine Instanz vom Typ System.AppDomain.
ICorRuntimeHost::CreateDomainEx-Methode	Erstellt eine Anwendungsdomäne. Diese Methode ermöglicht dem Aufrufer die Übergabe einer IAppDomainSetup-Instanz, um weitere Features der zurückgegebenen _AppDomain-Instanz zu konfigurieren.
ICorRuntimeHost::CreateDomainSetup-Methode	Ruft einen Schnittstellenzeiger vom Typ IAppDomainSetup auf eine AppDomainSetup-Instanz ab. IAppDomainSetup stellt Methoden zum Konfigurieren der Aspekte einer Anwendungsdomäne vor deren Erstellung bereit.
ICorRuntimeHost::CreateEvidence-Methode	Ruft einen Schnittstellenzeiger vom Typ IIdentity ab, mit dem der Host einen Sicherheitsbeweis zur Übergabe an CreateDomain oder CreateDomainEx erstellen kann.
ICorRuntimeHost::CreateLogicalThreadState-Methode	Keine Verwendung.
ICorRuntimeHost::CurrentDomain-Methode	Ruft einen Schnittstellenzeiger vom Typ _AppDomain ab, der die im aktuellen Thread geladene Domäne darstellt.
ICorRuntimeHost::DeleteLogicalThreadState-Methode	Keine Verwendung.
ICorRuntimeHost::EnumDomains-Methode	Ruft einen Enumerator für die Domänen im aktuellen Prozess ab.
ICorRuntimeHost::GetConfiguration-Methode	Ruft ein Objekt ab, mit dem der Host die Rückrufkonfiguration der CLR angeben kann.
ICorRuntimeHost::GetDefaultDomain-Methode	Ruft einen Schnittstellenzeiger des Typs _AppDomain ab, der die Standarddomäne des aktuellen Prozesses darstellt.
ICorRuntimeHost::LocksHeldByLogicalThread-Methode	Keine Verwendung.
ICorRuntimeHost::MapFile-Methode	Ordnet die angegebene Datei im Arbeitsspeicher zu. Diese Methode ist veraltet.
ICorRuntimeHost::NextDomain-Methode	Ruft einen Schnittstellenzeiger auf die nächste Domäne in der Enumeration ab.
ICorRuntimeHost::Start-Methode	Startet die CLR.
ICorRuntimeHost::Stop-Methode	Beendet die Ausführung des Codes in der Laufzeit für den aktuellen Prozess.
ICorRuntimeHost::SwitchInLogicalThreadState-Methode	Keine Verwendung.
ICorRuntimeHost::SwitchOutLogicalThreadState-Methode	Keine Verwendung.
ICorRuntimeHost::CurrentDomain-Methode	Entlädt die angegebene Anwendungsdomäne aus dem aktuellen Prozess.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.idl

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 1.0, 1.1

Siehe auch

Last updated on 2008-08-20

Freigeben über

ICorRuntimeHost

Methoden

Anforderungen

Siehe auch

Konzepte

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen