Dela via


RegisterForRuntimeStartup-funktionen

Kör återanropet när .NET-körningen startar i den angivna processen.

Syntax

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

Parameterar

dwProcessId
[i] Process-ID för målprocessen.

pfnCallback
[i] Ett återanrop som anropas när körningen startar. Se PSTARTUP_CALLBACK funktionspekare.

parameter
[in] datapekaren skickades till pfnCallback.

ppUnregisterToken
[out] pekare för att returnera Token UnregisterForRuntimeStartup .

Returvärde

S_OK
Återanropet har registrerats.

E_INVALIDARG
Antingen pfnCallback eller ppUnregisterToken är null.

E_FAIL (eller andra E_ returkoder)
Återanropsregistreringen misslyckades.

Anmärkningar

Återanropet skickas rätt ICorDebug-instans för körningsversionen eller ett fel om något misslyckas. Det här API:et fungerar för start och anslutning (och även attach-scenariot om körningen inte har lästs in ännu) på samma sätt på både xplat och Windows. Återanropet anropas alltid på en separat tråd. Det här API:et returnerar omedelbart. Återanropet anropas när coreclr-körningsmodulen läses in under den tidiga initieringen. Körningen blockeras under initieringen tills återanropet returneras. Om körningen redan har lästs in i processen (som i det normala kopplingsfallet) körs återanropet och körningen blockeras inte. Återanropet anropas alltid i en separat tråd och det här API:et returneras omedelbart. Endast den första coreclr-modulinstansen som hittades i målprocessen stöds för närvarande.

Kravspecifikation

Plattformar: Se Operativsystem som stöds av .NET.

Rubrik: dbgshim.h

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

.NET-versioner: Tillgänglig sedan .NET Core 2.1