Funzione CorBindToRuntimeHost
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
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per