ICLRMetaHost::RequestRuntimeLoadedNotification – metoda

Článek
05/10/2023

Poskytuje funkci zpětného volání, která se zaručuje, že bude volána při prvním načtení verze modulu CLR (Common Language Runtime), ale ještě není spuštěna. Tato metoda nahrazuje funkci LockClrVersion .

Syntaxe

HRESULT RequestRuntimeLoadedNotification (  
    [in] RuntimeLoadedCallbackFnPtr pCallbackFunction);

Parametry

pCallbackFunction
[v] Funkce zpětného volání, která je vyvolána při načtení nového modulu runtime.

Návratová hodnota

Tato metoda vrátí následující konkrétní hodnoty HRESULT a také chyby HRESULT, které značí selhání metody.

HRESULT	Description
S_OK	Metoda se úspěšně dokončila.
E_POINTER	`pCallbackFunction` je null.

Poznámky

Zpětné volání funguje následujícím způsobem:

Zpětné volání se vyvolá pouze při prvním načtení modulu runtime.
Zpětné volání není vyvoláno pro opakované načtení stejného modulu runtime.
Pro načtení modulu runtime bez opakování jsou volání funkce zpětného volání serializována.

Funkce zpětného volání má následující prototyp:

typedef void (__stdcall *RuntimeLoadedCallbackFnPtr)(  
                     ICLRRuntimeInfo *pRuntimeInfo,  
                     CallbackThreadSetFnPtr pfnCallbackThreadSet,  
                     CallbackThreadUnsetFnPtr pfnCallbackThreadUnset);

Prototypy funkce zpětného volání jsou následující:

pfnCallbackThreadSet:

typedef HRESULT (__stdcall *CallbackThreadSetFnPtr)();

pfnCallbackThreadUnset:

typedef HRESULT (__stdcall *CallbackThreadUnsetFnPtr)();

Pokud hostitel má v úmyslu načíst nebo způsobit opakované načtení jiného modulu runtime, pfnCallbackThreadSet musí být parametry a pfnCallbackThreadUnset , které jsou poskytovány ve funkci zpětného volání, použity následujícím způsobem:

pfnCallbackThreadSet musí být volána vláknem, které může způsobit zatížení za běhu před pokusem o takové načtení.
pfnCallbackThreadUnset musí být volána, pokud vlákno již nezpůsobí takové zatížení modulu runtime (a před návratem z počátečního zpětného volání).
pfnCallbackThreadSet a pfnCallbackThreadUnset obě nejsou znovu zaváděné.

Poznámka

Hostitelské aplikace nesmí volat pfnCallbackThreadSet a pfnCallbackThreadUnset mimo rozsah parametru pCallbackFunction .

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MetaHost.h

Knihovny: Zahrnuto jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od 4

Sdílet prostřednictvím