IDebugControl4::GetLastEventInformationWide-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetLastEventInformationWide Methode gibt Informationen zum letzten Ereignis zurück, das in einem Ziel aufgetreten ist.

Syntax

HRESULT GetLastEventInformationWide(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed,
  [out, optional] PWSTR  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 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, wie durch den zurückgegebenen Type-Parameter angegeben. Wenn z. B. Type haltepunkt ist, enthält ExtraInformation- eine DEBUG_LAST_EVENT_INFO_BREAKPOINT; wenn 'Type' "Exception" ist, enthält ExtraInformation einen DEBUG_LAST_EVENT_INFO_EXCEPTION. In DEBUG_EVENT_XXX finden Sie die vollständige Liste der Ereignistypen und die Dbgeng.h-Headerdatei für die Strukturdefinitionen für jeden Ereignistyp.

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 die Thread-ID und die Prozess-ID an ThreadId- zurückgegeben, und ProcessId- sind für den neu erstellten Thread oder Prozess vorgesehen.

Weitere Informationen zum letzten Ereignis finden Sie im Thema Ereignisinformationen.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

GetStoredEventInformation

IDebugControl4-

Freigeben über