Sdílet prostřednictvím

LockClrVersion – funkce

  • Článek

Umožňuje hostiteli určit, která verze modulu CLR (Common Language Runtime) se použije v rámci procesu před explicitní inicializací modulu CLR.

Tato funkce je v rozhraní .NET Framework 4 zastaralá.

Syntaxe

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

Parametry

hostCallback
[v] Funkce, která má být volána clr při inicializaci.

pBeginHostSetup
[v] Funkce, která má být volána hostitelem, aby informovala CLR, že se spouští inicializace.

pEndHostSetup
[v] Funkce, která má být volána hostitelem, aby informovala CLR, že inicializace je dokončena.

Návratová hodnota

Tato metoda vrátí kromě následujících hodnot standardní kódy chyb modelu COM definované v souboru WinError.h.

Návratový kód Description
S_OK Metoda byla úspěšně dokončena.
E_INVALIDARG Jeden nebo více argumentů má hodnotu null.

Poznámky

Hostitel volá LockClrVersion před inicializací MODULU CLR. LockClrVersion přijímá tři parametry, z nichž všechny jsou zpětná volání typu FLockClrVersionCallback. Tento typ je definován následujícím způsobem.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

Při inicializaci modulu runtime dojde k následujícím krokům:

  1. Hostitel volá CorBindToRuntimeEx nebo jednu z dalších inicializačních funkcí modulu runtime. Případně může hostitel inicializovat modul runtime pomocí aktivace objektu COM.

  2. Modul runtime volá funkci určenou parametrem hostCallback .

  3. Funkce určená parametrem hostCallback pak provede následující posloupnost volání:

Všechna volání z pBeginHostSetup do musí proběhnout pEndHostSetup v jednom vlákně nebo vlákně se stejným logickým zásobníkem. Toto vlákno se může lišit od vlákna, na kterém hostCallback je volána.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

Knihovna: MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také