functie RegisterForRuntimeStartupEx

Hiermee wordt de callback uitgevoerd wanneer de .NET-runtime in het opgegeven proces wordt gestart.

Syntaxis

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

Parameterwaarden

dwProcessId
[in] De proces-id van het doelproces.

lpApplicationGroupId
[in] Een tekenreeks die de id van de toepassingsgroep vertegenwoordigt van een sandboxproces dat wordt uitgevoerd in Mac. Geef NULL door als het proces niet wordt uitgevoerd in een sandbox en andere platforms.

pfnCallback
[in] Een callback die wordt aangeroepen wanneer de runtime wordt gestart. Zie PSTARTUP_CALLBACK functie aanwijzer.

parameter
[in] gegevenspointer doorgegeven aan pfnCallback.

ppUnregisterToken
[out] aanwijzer om het token UnregisterForRuntimeStartup te retourneren.

Retourwaarde

S_OK
De callback van het opstarten is geregistreerd.

E_INVALIDARG
pfnCallback Of ppUnregisterToken is null.

E_FAIL (of andere E_ retourcodes)
De callback-registratie is mislukt.

Opmerkingen

De callback wordt doorgegeven aan het juiste ICorDebug-exemplaar voor de versie van de runtime of een fout als er iets mislukt. Deze API werkt voor het starten en koppelen (en zelfs het bijlagescenario als de runtime nog niet is geladen) evenzeer op zowel xplat als Windows. De callback wordt altijd aangeroepen op een afzonderlijke thread. Deze API retourneert onmiddellijk. De callback wordt aangeroepen wanneer de coreclr-runtimemodule tijdens een vroege initialisatie wordt geladen. De runtime wordt geblokkeerd tijdens de initialisatie totdat de callback wordt geretourneerd. Als de runtime al in het proces is geladen (zoals in het normale attach-geval), wordt de callback uitgevoerd en wordt de runtime niet geblokkeerd. De callback wordt altijd aangeroepen op een afzonderlijke thread en deze API retourneert onmiddellijk. Alleen het eerste coreclr-module-exemplaar dat in het doelproces is gevonden, wordt momenteel ondersteund.

Behoeften

Platformen: Zie ondersteunde besturingssystemen van .NET.

Koptekst: dbgshim.h

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

.NET-versies: Beschikbaar sinds .NET Core 2.1