Funzione LockClrVersion

Articolo
05/10/2023

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

Questa funzione è stata deprecata in .NET Framework 4.

Sintassi

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

Parametri

hostCallback
[in] Funzione da chiamare da CLR al momento dell'inizializzazione.

pBeginHostSetup
[in] Funzione da chiamare dall'host per informare CLR che l'inizializzazione è in corso.

pEndHostSetup
[in] Funzione da chiamare dall'host per informare CLR che l'inizializzazione è stata completata.

Valore restituito

Questo metodo restituisce codici di errore COM standard, come definito in WinError.h, oltre ai valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_INVALIDARG	Uno o più argomenti sono Null.

Commenti

L'host chiama LockClrVersion prima di inizializzare CLR. LockClrVersion accetta tre parametri, tutti callback di tipo FLockClrVersionCallback. Questo tipo è definito come segue.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

Al momento dell'inizializzazione del runtime vengono eseguiti i passaggi seguenti:

L'host chiama CorBindToRuntimeEx o una delle altre funzioni di inizializzazione del runtime. In alternativa, l'host potrebbe inizializzare il runtime usando l'attivazione di oggetti COM.
Il runtime chiama la funzione specificata dal hostCallback parametro .
La funzione specificata da hostCallback effettua quindi la sequenza di chiamate seguente:
- Funzione specificata dal pBeginHostSetup parametro .
- CorBindToRuntimeEx (o un'altra funzione di inizializzazione di runtime).
- ICLRRuntimeHost::SetHostControl.
- ICLRRuntimeHost::Start.
- Funzione specificata dal pEndHostSetup parametro .

Tutte le chiamate da pBeginHostSetup a pEndHostSetup devono essere eseguite su un singolo thread o fiber, con lo stesso stack logico. Questo thread può essere diverso dal thread su cui hostCallback viene chiamato .

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 2.0

Vedi anche

Funzioni di hosting CLR deprecate

Condividi tramite