IDebugControl3::GetLastEventInformation-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetLastEventInformation Methode gibt Informationen über das letzte Ereignis zurück, das in einem Ziel aufgetreten ist.

Syntax

HRESULT GetLastEventInformation(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed,
  [out, optional] PSTR   Description,
  [in]            ULONG  DescriptionSize,
  [out, optional] PULONG DescriptionUsed
);

Parameter

[out] Type

Empfängt den Typ des letzten Ereignisses, das vom Ziel generiert wurde. Eine Liste der möglichen Typen finden Sie unter DEBUG_EVENT_XXX.

[out] ProcessId

Empfängt die Prozess-ID des Prozesses, in dem das Ereignis aufgetreten ist. Wenn diese Informationen nicht verfügbar sind, werden stattdessen DEBUG_ANY_ID zurückgegeben.

[out] ThreadId

Empfängt den Threadindex (nicht die Thread-ID) des Threads, in dem das letzte Ereignis aufgetreten ist. Wenn diese Informationen nicht verfügbar sind, werden stattdessen DEBUG_ANY_ID zurückgegeben.

[out, optional] ExtraInformation

Empfängt zusätzliche Informationen über das Ereignis. Der Inhalt dieser zusätzlichen Informationen hängt vom Typ des Ereignisses ab. Wenn ExtraInformation-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] ExtraInformationSize

Gibt die Größe des Puffers in Bytes an, der ExtraInformation- angibt.

[out, optional] ExtraInformationUsed

Empfängt die Größe von zusätzlichen Informationen in Bytes. Wenn ExtraInformationUsedNULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] Description

Empfängt die Beschreibung des Ereignisses. Wenn DescriptionNULL-ist, werden diese Informationen nicht zurückgegeben.

[in] DescriptionSize

Gibt die Größe des Puffers in Zeichen an, der Beschreibung angibt. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] DescriptionUsed

Empfängt die Größe in Zeichen der Beschreibung des Ereignisses. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn DescriptionUsed-NULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Allerdings waren ExtraInformationSize oder DescriptionSize kleiner, dass die Größe der jeweiligen Daten oder Zeichenfolgen und die Daten oder Zeichenfolge abgeschnitten wurde, um in den Puffer einzupassen.

Bemerkungen

Bei Thread- und Prozesserstellungsereignissen werden der Threadindex und die Prozess-ID, die an ThreadId- zurückgegeben wird, und ProcessId- für den neu erstellten Thread oder Prozess verwendet.

Weitere Informationen zum letzten Ereignis finden Sie im Thema Ereignisinformationen.