ICLRRuntimeHost

Aggiornamento: novembre 2007

Fornisce una funzionalità simile a quella dell'interfaccia ICorRuntimeHost disponibile in .NET Framework versione 1, con le seguenti differenze:

L'aggiunta del metodo SetHostControl per impostare l'interfaccia di controllo host.
L'omissione di alcuni metodi forniti da 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
    );
        
};

Metodi

Metodo	Descrizione
Metodo ICLRRuntimeHost::ExecuteApplication	Utilizzato negli scenari di distribuzione ClickOnce basati su manifesto per specificare l'applicazione che deve essere attivata in un nuovo dominio.
Metodo ICLRRuntimeHost::ExecuteInAppDomain	Specifica il dominio AppDomain in cui eseguire il codice gestito specificato.
Metodo ICLRRuntimeHost::ExecuteInDefaultAppDomain	Richiama il metodo specificato del tipo specificato nell'assembly specificato.
Metodo ICLRRuntimeHost::GetCLRControl	Ottiene un puntatore a interfaccia di tipo ICLRControl che gli host possono utilizzare per la personalizzazione di aspetti di Common Language Runtime (CLR).
Metodo ICLRRuntimeHost::GetCurrentAppDomainId	Ottiene l'identificatore numerico dell'oggetto AppDomain attualmente in esecuzione.
Metodo ICLRRuntimeHost::SetHostControl	Imposta l'interfaccia di controllo host. È necessario chiamare SetHostControl prima di chiamare Start.
Metodo ICLRRuntimeHost::Start	Inizializza Common Language Runtime in un processo.
Metodo ICLRRuntimeHost::Stop	Arresta l'esecuzione di codice da parte del runtime.
Metodo ICLRRuntimeHost::UnloadAppDomain	Scarica AppDomain che corrisponde all'identificatore numerico specificato.

Note

L’host ottiene un puntatore a un'istanza di ICLRRuntimeHost mediante una chiamata a CorBindToRuntimeEx o a CorBindToCurrentRuntime. Per consentire l'implementazione delle tecnologie fornite con .NET Framework versione 2.0, è necessario utilizzare ICLRRuntimeHost anziché ICorRuntimeHost.

Nota importante:
Non chiamare il metodo Start prima di chiamare il metodo ExecuteApplication per attivare un'applicazione basata su manifesto. Se viene chiamato prima il metodo Start, la chiamata al metodo ExecuteApplication avrà esito negativo.