Funzione LockClrVersion

Articolo
08/11/2011

Consente all'host di determinare quale versione di Common Language Runtime (CLR) verrà utilizzata all'interno del processo prima di inizializzare CLR in modo esplicito.

Questa funzione è deprecata in .NET Framework versione 4.

HRESULT LockClrVersion (
    [in] FLockClrVersionCallback   hostCallback,
    [in] FLockClrVersionCallback  *pBeginHostSetup,
    [in] FLockClrVersionCallback  *pEndHostSetup
);

Parametri

hostCallback
[in] Funzione che deve essere chiamata da Common Language Runtime al momento dell'inizializzazione.
pBeginHostSetup
[in] Funzione che deve essere chiamata dall'host per notificare a Common Language Runtime che l'inizializzazione sta per cominciare.
pEndHostSetup
[in] Funzione che deve essere chiamata dall'host per notificare a Common Language Runtime che l'inizializzazione è stata completata.

Valore restituito

Questo metodo restituisce i codici di errore COM standard definiti in WinError.h, oltre ai valori riportati di seguito.

Codice restituito	Oggetto di descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	Uno o più argomenti sono null.

Note

L'host chiama LockClrVersion prima dell'inizializzazione di CLR. LockClrVersion accetta tre parametri, che sono tutti callback di tipo FLockClrVersionCallback. Questo tipo è definito nel modo seguente.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

Durante l'inizializzazione del runtime vengono eseguiti i passaggi indicati di seguito:

L'host chiama CorBindToRuntimeEx o una delle altre funzioni di inizializzazione del runtime. In alternativa, l'host può inizializzare il runtime mediante l'attivazione di oggetti COM.
Il runtime chiama la funzione specificata dal parametro hostCallback.
La funzione specificata da hostCallback esegue quindi la sequenza di chiamate indicata di seguito:
- La funzione specificata dal parametro pBeginHostSetup.
- CorBindToRuntimeEx o un'altra funzione di inizializzazione del runtime.
- ICLRRuntimeHost::SetHostControl.
- ICLRRuntimeHost::Start.
- La funzione specificata dal parametro pEndHostSetup.

Tutte le chiamate da pBeginHostSetup a pEndHostSetup devono essere effettuate su un fiber o thread singolo, con lo stesso stack logico. Questo thread può essere diverso da quello su cui si esegue la chiamata a hostCallback.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: MSCorEE.dll

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Altre risorse

Funzioni statiche globali di hosting di .NET Framework 1.1 e 2.0

Condividi tramite