Funktionen LockClrVersion

Gör att värden kan avgöra vilken version av CLR (Common Language Runtime) som ska användas i processen innan CLR uttryckligen initieras.

Den här funktionen är inaktuell i .NET Framework 4.

Syntax

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

Parametrar

hostCallback
[in] Funktionen som ska anropas av CLR vid initiering.

pBeginHostSetup
[in] Funktionen som anropas av värden för att informera CLR om att initieringen startar.

pEndHostSetup
[in] Funktionen som anropas av värden för att informera CLR om att initieringen är klar.

Returvärde

Den här metoden returnerar COM-standardfelkoder, enligt definitionen i WinError.h, utöver följande värden.

Kommentarer

Värden anropar LockClrVersion innan CLR initieras. LockClrVersion tar tre parametrar, som alla är återanrop av typen FLockClrVersionCallback. Den här typen definieras på följande sätt.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();  

Följande steg utförs vid initiering av körningen:

1. Värden anropar CorBindToRuntimeEx eller någon av de andra körningsinitieringsfunktionerna. Alternativt kan värden initiera körningen med hjälp av COM-objektaktivering.

2. Körningen anropar funktionen som anges av parametern hostCallback .

3. Funktionen som anges av hostCallback gör sedan följande anropssekvens:

   • Funktionen som anges av parametern pBeginHostSetup .

   • CorBindToRuntimeEx (eller en annan körningsinitieringsfunktion).

   • ICLRRuntimeHost::SetHostControl.

   • ICLRRuntimeHost::Start.

   • Funktionen som anges av parametern pEndHostSetup .

Alla anrop från pBeginHostSetup till pEndHostSetup måste ske på en enda tråd eller fiber, med samma logiska stack. Den här tråden kan skilja sig från tråden som hostCallback anropas på.

Krav

Plattformar: Se Systemkrav.

Huvudet: MSCorEE.h

Bibliotek: MSCorEE.dll

.NET Framework versioner: Tillgänglig sedan 2.0

Se även

• Inaktuella CLR-värdfunktioner