RegisterForRuntimeStartup – funkce

Spustí zpětné volání při spuštění modulu runtime .NET v zadaném procesu.

Syntaxe

HRESULT RegisterForRuntimeStartup (
    [in] DWORD dwProcessId,
    [in] PSTARTUP_CALLBACK pfnCallback,
    [in] PVOID parameter,
    [out] PVOID *ppUnregisterToken)
);

Parametry

dwProcessId
[v] ID procesu cílového procesu.

pfnCallback
[v] Zpětné volání, které se vyvolá při spuštění modulu runtime. Viz PSTARTUP_CALLBACK ukazatel funkce.

parameter
[in] datový ukazatel předaný do pfnCallback.

ppUnregisterToken
[out] ukazatel pro vrácení tokenu UnregisterForRuntimeStartup .

Návratová hodnota

S_OK
Zpětné volání po spuštění bylo úspěšně zaregistrováno.

E_INVALIDARG
Buď pfnCallback nebo ppUnregisterToken má hodnotu null.

E_FAIL (nebo jiné E_ návratové kódy)
Registrace zpětného volání se nezdařila.

Poznámky

Zpětné volání se předá správné instanci ICorDebug pro verzi modulu runtime nebo chybu, pokud něco selže. Toto rozhraní API funguje pro spuštění a připojení (a dokonce i scénář připojení, pokud modul runtime ještě nebyl načten) rovnoměrně na platformě xplat i Windows. Zpětné volání se vždy volá na samostatném vlákně. Toto rozhraní API se vrátí okamžitě. Zpětné volání se vyvolá, když se modul runtime coreclr načte během počáteční inicializace. Modul runtime se během inicializace zablokuje, dokud se zpětná volání nevrátí. Pokud je modul runtime již načtený v procesu (stejně jako v normálním případě připojení), provede se zpětné volání a modul runtime není blokovaný. Zpětné volání se vždy vyvolá na samostatném vlákně a toto rozhraní API se vrátí okamžitě. Aktuálně se podporuje pouze první instance modulu coreclr nalezená v cílovém procesu.

Požadavky

Platformy: Viz podporované operační systémy .NET.

Hlavička: dbgshim.h

Knihovna: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Verze .NET: K dispozici od .NET Core 2.1