Funzione CorBindToRuntimeHost

  • Articolo

Consente agli host di caricare una versione specificata di Common Language Runtime (CLR) in un processo.

Questa funzione è stata deprecata in .NET Framework 4.

Sintassi

HRESULT CorBindToRuntimeHost (  
    [in] LPCWSTR       pwszVersion,
    [in] LPCWSTR       pwszBuildFlavor,
    [in] LPCWSTR       pwszHostConfigFile,
    [in] VOID*         pReserved,
    [in] DWORD         startupFlags,
    [in] REFCLSID      rclsid,
    [in] REFIID        riid,
    [out] LPVOID FAR  *ppv  
);

Parametri

pwszVersion
[in] Stringa che descrive la versione di CLR da caricare.

Un numero di versione in .NET Framework è costituito da quattro parti separate da periodi: major.minor.build.revision. La stringa passata come pwszVersion deve iniziare con il carattere "v" seguito dalle prime tre parti del numero di versione ,ad esempio "v1.0.1529").

Alcune versioni di CLR vengono installate con un'istruzione criteri che specifica la compatibilità con le versioni precedenti di CLR. Per impostazione predefinita, lo shim di avvio restituisce pwszVersion le istruzioni dei criteri e carica la versione più recente del runtime compatibile con la versione richiesta. Un host può forzare lo shim per ignorare la valutazione dei criteri e caricare la versione esatta specificata in pwszVersion passando un valore di STARTUP_LOADER_SAFEMODE per il startupFlags parametro.

Se pwszVersion è null, il metodo non carica alcuna versione di CLR. Restituisce invece CLR_E_SHIM_RUNTIMELOAD, che indica che non è riuscito a caricare il runtime.

pwszBuildFlavor
[in] Stringa che specifica se caricare il server o la compilazione della workstation di CLR. I valori validi sono svr e wks. La compilazione del server è ottimizzata per sfruttare più processori per le garbage collection e la compilazione della workstation è ottimizzata per le applicazioni client in esecuzione in un computer a processore singolo.

Se pwszBuildFlavor è impostato su Null, la compilazione della workstation viene caricata. Quando si esegue in un computer a processore singolo, la compilazione della workstation viene sempre caricata, anche se pwszBuildFlavor è impostata su svr. Tuttavia, se pwszBuildFlavor è impostato su svr e garbage collection simultaneo viene specificato (vedere la descrizione del parametro), viene caricata la compilazione del startupFlags server.

Nota

La Garbage Collection simultanea non è supportata nelle applicazioni che eseguono l'emulatore WOW64 x86 nei sistemi a 64 bit che implementano l'architettura Intel Itanium (in precedenza denominata IA-64). Per altre informazioni sull'uso di WOW64 nei sistemi Windows a 64 bit, vedere Esecuzione di applicazioni a 32 bit.

pwszHostConfigFile
[in] Nome di un file di configurazione host che specifica la versione di CLR da caricare. Se il nome del file non include un percorso completo, si presuppone che il file sia nella stessa directory dell'eseguibile che esegue la chiamata.

pReserved
[in] Riservato per l'estendibilità futura.

startupFlags
[in] Set di flag che controllano la Garbage Collection simultanea, il codice neutrale del dominio e il comportamento del pwszVersion parametro. Il valore predefinito è un singolo dominio se non è impostato alcun flag. Per un elenco di valori supportati, vedere l'enumerazione STARTUP_FLAGS.

rclsid
[in] Classe CLSID della coclasse che implementa l'interfaccia ICorRuntimeHost o ICLRRuntimeHost . I valori supportati sono CLSID_CorRuntimeHost o CLSID_CLRRuntimeHost.

riid
[in] Oggetto IID dell'interfaccia che si sta richiedendo. I valori supportati sono IID_ICorRuntimeHost o IID_ICLRRuntimeHost.

ppv
[out] Puntatore dell'interfaccia alla versione del runtime caricata.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.idl

Libreria: MSCorEE.dll

Versioni di .NET Framework: Disponibile da 1.0

Vedi anche