Condividi tramite

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 punti: 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 dei criteri che specifica la compatibilità con le versioni precedenti di CLR. Per impostazione predefinita, lo shim di avvio valuta le pwszVersion istruzioni dei criteri e carica la versione più recente del runtime compatibile con la versione richiesta. Un host può forzare lo shim a 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 è stato possibile caricare il runtime.

pwszBuildFlavor
[in] Stringa che specifica se caricare il server o la build workstation di CLR. I valori validi sono svr e wks. La compilazione del server è ottimizzata per sfruttare i vantaggi di più processori per 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 viene eseguito 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 viene specificata la procedura di Garbage Collection simultanea (vedere la descrizione del startupFlags parametro), la compilazione del server viene caricata.

Nota

La Garbage Collection simultanea non è supportata nelle applicazioni che eseguono l'emulatore WOW64 x86 in 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 file non include un percorso completo, si presuppone che il file si trova 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 indipendente dal dominio e il comportamento del pwszVersion parametro. Il valore predefinito è un singolo dominio se non è impostato alcun flag. Per un elenco dei valori supportati, vedere l'enumerazione STARTUP_FLAGS.

rclsid
[in] Oggetto 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 richiesta. 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.

Intestazione: MSCorEE.idl

Libreria: MSCorEE.dll

Versioni di .NET Framework: disponibili dalla versione 1.0

Vedi anche