ICLRRuntimeHost

Artikel
09/02/2008

Aktualisiert: November 2007

Stellt Funktionen ähnlich zu denen der in .NET Framework, Version 1, bereitgestellten ICorRuntimeHost-Schnittstelle mit den folgenden Änderungen bereit:

Hinzufügen der SetHostControl-Methode, um die Schnittstelle des Hoststeuerelements festzulegen.
Auslassen einiger Methoden, die von ICorRuntimeHost bereitgestellt wurden.

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

Methoden

Methode	Beschreibung
ICLRRuntimeHost::ExecuteApplication-Methode	Wird in manifestbasierten -Szenarien der ClickOnce-Bereitstellung zum Angeben der Anwendung verwendet, die in einer neuen Domäne aktiviert werden soll.
ICLRRuntimeHost::ExecuteInAppDomain-Methode	Gibt die AppDomain an, in der der angegebene verwaltete Code ausgeführt werden soll.
ICLRRuntimeHost::ExecuteInDefaultAppDomain-Methode	Ruft die angegebene Methode des angegebenen Typs in der angegebenen Assembly auf.
ICLRRuntimeHost::GetCLRControl-Methode	Ruft einen Schnittstellenzeiger vom Typ ICLRControl ab, den Hosts zum Anpassen von Aspekten der Common Language Runtime (CLR) verwenden können.
ICLRRuntimeHost::GetCurrentAppDomainId-Methode	Ruft den numerischen Bezeichner der aktuell ausgeführten AppDomain ab.
ICLRRuntimeHost::SetHostControl-Methode	Legt die Schnittstelle des Hoststeuerelements fest. Sie müssen SetHostControl vor Start aufrufen.
ICLRRuntimeHost::Start-Methode	Initialisiert die CLR in einem Prozess.
ICLRRuntimeHost::Stop-Methode	Beendet die Ausführung des Codes durch die Laufzeit.
ICLRRuntimeHost::UnloadAppDomain-Methode	Entlädt die AppDomain, die dem angegebenen numerischen Bezeichner entspricht.

Hinweise

Der Host ruft einen Zeiger auf eine ICLRRuntimeHost-Instanz ab, indem er CorBindToRuntimeEx oder CorBindToCurrentRuntime aufruft. Anstelle von ICorRuntimeHost müssen Sie ICLRRuntimeHost verwenden, um Implementierungen der in .NET Framework, Version 2.0, zur Verfügung stehenden Technologien bereitzustellen.

Wichtiger Hinweis:
Die Start-Methode sollte nicht vor dem Aufruf der ExecuteApplication-Methode aufgerufen werden, um eine manifestbasierte Anwendung zu aktivieren. Wenn die Start-Methode zuerst aufgerufen wird, schlägt der ExecuteApplication-Methodenaufruf fehl.