GetStartupNotificationEvent-Funktion

Artikel
03/03/2024

Erstellt oder öffnet ein Ereignishandle, das über jede CLR-Runtime (Common Language Runtime) benachrichtigt wird, die im angegebenen Zielprozess geladen wird. Diese API ist nur Windows.

Syntax

HRESULT GetStartupNotificationEvent (
    [in]  DWORD     debuggeePID,
    [out]  HANDLE*  phStartupEvent
);

Parameter

debuggeePID
[in] Prozessbezeichner des Zielprozesses, von dem CLR-Startbenachrichtigungen empfangen werden.

phStartupEvent
[out] Ein Zeiger auf ein Handle, das von einer CRL beim Start signalisiert wird.

Rückgabewert

S_OK
Das Handle für das Start-Benachrichtigungsereignis wurde wurde erfolgreich empfangen.

E_INVALIDARG
phStartupEvent ist Null oder debuggeePID bezieht sich nicht auf einen Prozess, der derzeit ausgeführt wird.

E_FAIL (oder andere E_-Rückgabecodes)
Das Handle zum Start-Benachrichtigungsereignis konnte nicht abgerufen werden.

Bemerkungen

Unter dem Windows-Betriebssystem wird debuggeePID einem Betriebssystem-Prozessbezeichner zugeordnet.

Das Ereignis wird signalisiert, bevor irgendwelcher verwalteter Code von der CLR ausgeführt wurde, die das Ereignis signalisiert hat.

Anforderungen

Plattformen: Siehe Von .NET unterstützte Betriebssysteme.

Header: dbgshim.h

Library: dbgshim.dll

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

Teilen über