Funzione CorBindToRuntimeHost

Articolo
08/11/2011

Consente agli host di caricare una determinata versione di Common Language Runtime in un processo.

Questa funzione è deprecata in .NET Framework versione 4.

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 Common Language Runtime che si desidera caricare.

Un numero di versione in .NET Framework è costituito da quattro parti separate da punti: principale.secondario.build.revisione. La stringa passata come parametro pwszVersion deve iniziare con il carattere "v" seguito dalle prime tre parti del numero di versione (ad esempio, "v1.0.1529").

Alcune versioni di Common Language Runtime vengono installate con un'istruzione dei criteri che specifica la compatibilità con le versioni precedenti di Common Language Runtime. Per impostazione predefinita, lo shim di avvio confronta il valore di pwszVersion con le istruzioni dei criteri e carica l'ultima versione di Common Language Runtime compatibile con la versione richiesta. Un host può imporre allo shim di ignorare la valutazione dei criteri e di caricare l'esatta versione specificata in pwszVersion passando un valore STARTUP_LOADER_SAFEMODE per il parametro startupFlags.

Se pwszVersion è null, il metodo non carica nessuna versione di CLR. Restituisce invece CLR_E_SHIM_RUNTIMELOAD, che indica che si è verificato un errore nel caricamento del runtime.

pwszBuildFlavor
[in] Stringa che specifica se deve essere caricata la build di Common Language Runtime per server o per workstation. I valori validi sono svr e wks. La build per server è ottimizzata per l'utilizzo di più processori durante le operazioni di Garbage Collection, mentre la build per workstation è ottimizzata per le applicazioni client eseguite su computer con singolo processore.

Se pwszBuildFlavor è impostato su null, verrà caricata la build per workstation. In caso di esecuzione su un computer con singolo processore, verrà sempre caricata la build per workstation, anche se il valore pwszBuildFlavor è impostato su svr. Se tuttavia pwszBuildFlavorviene impostato su svr e viene specificata l'esecuzione simultanea della Garbage Collection, come indicato nella descrizione del parametro startupFlags riportata di seguito, verrà caricata la build per server.

Nota
L'operazione di Garbage Collection in modalità simultanea non è supportata nelle applicazioni che eseguono l'emulatore WOW64 x86 su sistemi a 64 bit che implementano l'architettura Intel Itanium (precedentemente denominata IA-64).Per ulteriori informazioni sull'utilizzo di WOW64 nei sistemi Windows a 64 bit, vedere Running 32-bit Applications (informazioni in lingua inglese).

pwszHostConfigFile
[in] Nome di un file di configurazione host in cui viene specificata la versione di Common Language Runtime da caricare. Se nel nome file non è incluso un percorso completo, si presupporrà che il file si trovi nella stessa directory dell'eseguibile che effettua la chiamata.
pReserved
[in] Riservato per una futura estensibilità.
startupFlags
[in] Insieme di flag che controlla l'esecuzione simultanea della Garbage Collection, il codice indipendente dal dominio e il comportamento del parametro pwszVersion. Se non è impostato nessun flag, l'impostazione predefinita è un dominio singolo. Sono supportati i seguenti valori:
- STARTUP_CONCURRENT_GC: specifica che deve essere eseguita la Garbage Collection in modalità simultanea. Se il chiamante chiede il caricamento della build per server e specifica l'esecuzione simultanea della Garbage Collection su un computer con singolo processore, verranno invece eseguite la build per workstation e la versione non simultanea della Garbage Collection.
- STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN: specifica che nessun assembly deve essere caricato come indipendente dal dominio.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN: specifica che tutti gli assembly devono essere caricati come indipendenti dal dominio.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST: specifica che tutti gli assembly con nome sicuro devono essere caricati come indipendenti dal dominio.
- STARTUP_LOADER_SAFEMODE: specifica che deve essere caricata la versione esatta di Common Language Runtime passata in pwszVersion. Nello shim non viene eseguita la valutazione dei criteri per determinare la più recente versione compatibile.
rclsid
[in] CLSID della coclasse che implementa l’interfaccia ICorRuntimeHost o l'interfaccia ICLRRuntimeHost. I valori supportati sono CLSID_CorRuntimeHost o CLSID_CLRRuntimeHost.
riid
[in] IID dell'interfaccia richiesta. I valori supportati sono IID_ICorRuntimeHost o IID_ICLRRuntimeHost.
ppv
[out] Puntatore a interfaccia alla versione di Common Language Runtime caricata.