RegisterForRuntimeStartup függvény

Végrehajtja a visszahívást, amikor a .NET-futtatókörnyezet elindul a megadott folyamat során.

Szemantika

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

Paraméterek

dwProcessId
[in] A célfolyamat folyamatazonosítója.

pfnCallback
[in] Visszahívás, amely a futtatókörnyezet indításakor lesz meghívva. Lásd PSTARTUP_CALLBACK függvénymutatót.

parameter
[in] adatmutató átadva a következőnek pfnCallback: .

ppUnregisterToken
[ki] mutató a UnregisterForRuntimeStartup jogkivonat visszaadásához .

Visszaadott érték

S_OK
Az indítási visszahívás regisztrálása sikeresen megtörtént.

E_INVALIDARG
pfnCallback Vagy ppUnregisterToken null értékű.

E_FAIL (vagy egyéb E_ visszatérési kódok)
A visszahívás regisztrációja nem sikerült.

Megjegyzések

A visszahívás a futtatókörnyezet verziójához tartozó megfelelő ICorDebug-példányt adja át, vagy hiba, ha valami nem sikerül. Ez az API az indításhoz és a csatoláshoz működik (és még a csatolási forgatókönyvhöz is, ha a futtatókörnyezet még nem lett betöltve) egyaránt az xplat és a Windows rendszeren. A visszahívás mindig külön szálon van meghívva. Ez az API azonnal visszatér. A rendszer akkor hívja meg a visszahívást, ha a coreclr futtatókörnyezet modulja be van töltve a korai inicializálás során. A futtatókörnyezet az inicializálás során le lesz tiltva, amíg a visszahívás vissza nem tér. Ha a futtatókörnyezet már be van töltve a folyamatban (a normál csatolási esethez hasonlóan), a rendszer végrehajtja a visszahívást, és a futtatókörnyezet nem lesz blokkolva. A visszahívás mindig külön szálon lesz meghívva, és ez az API azonnal visszatér. Jelenleg csak a célfolyamatban talált első coreclr-modulpéldány támogatott.

Követelmények

Platformok: Lásd: .NET által támogatott operációs rendszerek.

Fejléc: dbgshim.h

Könyvtár: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

.NET-verziók: A .NET Core 2.1 óta érhető el