LockClrVersion függvény

Lehetővé teszi a gazdagép számára, hogy meghatározza a közös nyelvi futtatókörnyezet (CLR) melyik verzióját fogja használni a folyamaton belül a CLR explicit inicializálása előtt.

Ez a függvény elavult a .NET-keretrendszer 4-ben.

Szintaxis

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

Paraméterek

hostCallback
[in] A CLR által az inicializáláskor meghívandó függvény.

pBeginHostSetup
[in] A gazdagép által meghívandó függvény, amely tájékoztatja a CLR-t az inicializálás indításáról.

pEndHostSetup
[in] A gazdagép által meghívandó függvény, amely tájékoztatja a CLR-t az inicializálás befejezéséről.

Visszatérési érték

Ez a metódus a WinError.h fájlban meghatározott szabványos COM-hibakódokat adja vissza az alábbi értékek mellett.

Visszatérési kód	Description
S_OK	A metódus sikeresen befejeződött.
E_INVALIDARG	Egy vagy több argumentum null értékű.

Megjegyzések

A gazdagép a CLR inicializálása előtt hív LockClrVersion . LockClrVersion három paramétert vesz fel, amelyek mindegyike FLockClrVersionCallback típusú visszahívás. Ez a típus a következőképpen van definiálva.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();  

A futtatókörnyezet inicializálásakor a következő lépések történnek:

1. A gazdagép meghívja a CorBindToRuntimeEx vagy a futtatókörnyezet inicializálási függvényeinek egyikét. Azt is megteheti, hogy a gazdagép COM-objektumaktiválással inicializálja a futtatókörnyezetet.

2. A futtatókörnyezet meghívja a paraméter által megadott függvényt hostCallback .

3. Az által hostCallback megadott függvény a következő hívássorozatot indítja el:

   • A paraméter által pBeginHostSetup megadott függvény.

   • CorBindToRuntimeEx (vagy egy másik futtatókörnyezet inicializálási függvénye).

   • ICLRRuntimeHost::SetHostControl.

   • ICLRRuntimeHost::Start.

   • A paraméter által pEndHostSetup megadott függvény.

A bejövő pEndHostSetup hívásoknak pBeginHostSetup egyetlen szálon vagy szálon kell történnie, ugyanazon a logikai veremen. Ez a szál eltérhet attól a száltól, amelyre hostCallback meghívják.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Kódtár: MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta elérhető

Lásd még

• Elavult CLR-üzemeltetési függvények