RegisterForRuntimeStartup-Funktion

Artikel
03/03/2024

Führt den Rückruf aus, wenn die .NET-Runtime im angegebenen Prozess startet.

Syntax

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

Parameter

dwProcessId
[in] Die Prozess-ID des Zielprozesses

pfnCallback
[in] Ein Rückruf, der beim Start der Runtime aufgerufen wird Siehe PSTARTUP_CALLBACK-Funktionszeiger.

parameter
[in] an pfnCallback übergebener Datenzeiger.

ppUnregisterToken
[out] Zeiger, um das Token UnregisterForRuntimeStartup zurückzugeben.

Rückgabewert

S_OK
Der Startup-Rückruf wurde erfolgreich registriert.

E_INVALIDARG
Entweder pfnCallback oder ppUnregisterToken ist null.

E_FAIL (oder andere E_-Rückgabecodes)
Fehler bei der Rückrufregistrierung.

Bemerkungen

An den Rückruf wird die richtige ICorDebug-Instanz für die Version der Runtime oder ein Fehler übergeben, wenn etwas fehlschlägt. Diese API funktioniert zum Starten und Anfügen (und sogar zum Anfügen, wenn die Runtime noch nicht geladen wurde) gleichermaßen unter xplat und Windows. Der Rückruf wird immer in einem separaten Thread aufgerufen. Diese API gibt sofort etwas zurück. Der Rückruf wird aufgerufen, wenn das Runtimemodul „coreclr“ während der frühen Initialisierung geladen wird. Die Runtime wird während der Initialisierung blockiert, bis der Rückruf etwas zurückgibt. Wenn die Runtime bereits im Prozess geladen wird (wie beim normalen Anfügen), wird der Rückruf ausgeführt, und die Runtime wird nicht blockiert. Der Rückruf wird immer in einem separaten Thread aufgerufen, und diese API gibt sofort etwas zurück. Nur die erste im Zielprozess gefundene „coreclr“-Modulinstanz wird derzeit unterstützt.

Anforderungen

Plattformen: Siehe Von .NET unterstützte Betriebssysteme.

Header: dbgshim.h

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

.NET-Versionen: verfügbar seit .NET Core 2.1

Teilen über