De functie LockClrVersion

Artikel
05/10/2023

Hiermee kan de host bepalen welke versie van de Common Language Runtime (CLR) in het proces wordt gebruikt voordat de CLR expliciet wordt geïnitialiseerd.

Deze functie is afgeschaft in de .NET Framework 4.

Syntaxis

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

Parameters

hostCallback
[in] De functie die moet worden aangeroepen door de CLR bij initialisatie.

pBeginHostSetup
[in] De functie die moet worden aangeroepen door de host om de CLR te informeren dat de initialisatie wordt gestart.

pEndHostSetup
[in] De functie die door de host moet worden aangeroepen om de CLR te informeren dat de initialisatie is voltooid.

Retourwaarde

Deze methode retourneert standaard COM-foutcodes, zoals gedefinieerd in WinError.h, naast de volgende waarden.

Retourcode	Beschrijving
S_OK	De methode is voltooid.
E_INVALIDARG	Een of meer van de argumenten is null.

Opmerkingen

De host roept aan LockClrVersion voordat de CLR wordt geïnitialiseerd. LockClrVersion neemt drie parameters, die allemaal callbacks van het type FLockClrVersionCallback zijn. Dit type wordt als volgt gedefinieerd.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

De volgende stappen worden uitgevoerd bij de initialisatie van de runtime:

De host roept CorBindToRuntimeEx of een van de andere runtime-initialisatiefuncties aan. De host kan de runtime ook initialiseren met behulp van COM-objectactivering.
De runtime roept de functie aan die is opgegeven met de hostCallback parameter .
De functie die door hostCallback is opgegeven, voert vervolgens de volgende reeks aanroepen uit:
- De functie die is opgegeven door de pBeginHostSetup parameter .
- CorBindToRuntimeEx (of een andere runtime-initialisatiefunctie).
- ICLRRuntimeHost::SetHostControl.
- ICLRRuntimeHost::Start.
- De functie die is opgegeven door de pEndHostSetup parameter .

Alle aanroepen van pBeginHostSetup naar pEndHostSetup moeten plaatsvinden op één thread of fiber, met dezelfde logische stack. Deze thread kan afwijken van de thread waarop hostCallback wordt aangeroepen.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Zie ook

Afgeschafte CLR-hostingfuncties

Delen via