Interfaccia ICLRMetaHost

Articolo
08/11/2011

Consente di fornire metodi che restituiscono una versione specifica di Common Language Runtime (CLR) in base al relativo numero di versione, elencano tutti i CLR installati, elencano tutti i runtime caricati in un processo specifico, individuano la versione di CLR utilizzata per compilare un assembly, chiudono un processo con un normale arresto del runtime ed eseguono una query per un'associazione API legacy.

Metodi

Metodo	Oggetto di descrizione
Metodo ICLRMetaHost::EnumerateInstalledRuntimes	Restituisce un'enumerazione che contiene un puntatore di interfaccia ICLRRuntimeInfo valido per ogni versione di CLR installata in un computer.
Metodo ICLRMetaHost::EnumerateLoadedRuntimes	Consente di restituire un'enumerazione contenente un puntatore a interfaccia valido ICLRRuntimeInfo per ogni CLR caricato in un processo specificato. Questo metodo sostituisce GetVersionFromProcess.
Metodo ICLRMetaHost::ExitProcess	Tenta di arrestare normalmente tutte le i runtime caricati e quindi termina il processo. Consente di sostituire la funzione CorExitProcess.
Metodo ICLRMetaHost::GetRuntime	Ottiene l'interfaccia ICLRRuntimeInfo che corrisponde ad una versione specifica di CLR. Questo metodo sostituisce la funzione CorBindToRuntimeEx utilizzata con il contrassegno STARTUP_LOADER_SAFEMODE.
Metodo ICLRMetaHost::GetVersionFromFile	Ottiene la versione di compilazione di .NET Framework originale dell'assembly (archiviata nei metadati), in base al relativo percorso di file. Questo metodo sostituisce GetFileVersion.
Metodo ICLRMetaHost::QueryLegacyV2RuntimeBinding	Consente di restituire un'interfaccia che rappresenta un runtime a cui sono stati associati i criteri di attivazione legacy, ad esempio utilizzando l'attributo useLegacyV2RuntimeActivationPolicy sulla voce del file di configurazione Elemento <startup>, mediante l'utilizzo diretto di API di attivazione legacy o chiamando il metodo ICLRRuntimeInfo::BindAsLegacyV2Runtime.
Metodo ICLRMetaHost::RequestRuntimeLoadedNotification	Garantisce un callback al puntatore a funzione specificato quando una versione di CLR viene caricata, ma non ancora avviata. Questo metodo sostituisce LockClrVersion.

Note

L'unico modo di ottenere un'istanza di questa interfaccia è chiamare la funzione CLRCreateInstance come mostrato di seguito:

ICLRMetaHost *pMetaHost = NULL;
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHost,
                   IID_ICLRMetaHost, (LPVOID*)&pMetaHost);

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MetaHost.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4

Vedere anche

Altre risorse

Interfacce di hosting

Hosting (riferimenti alle API non gestite)

Cronologia delle modifiche

Data	Cronologia	Motivo
Settembre 2010	È stato corretto l'IID in un elenco di codici.	Commenti e suggerimenti dei clienti.

Settembre 2010

È stato corretto l'IID in un elenco di codici.

Commenti e suggerimenti dei clienti.

Condividi tramite