IDebugControl4::GetLastEventInformationWide-Methode (dbgeng.h)

  • Artikel

Die GetLastEventInformationWide-Methode gibt Informationen über das letzte 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 zum Ereignis. Der Inhalt dieser zusätzlichen Informationen hängt vom Typ des Ereignisses ab, der durch den zurückgegebenen Type-Parameter angegeben wird. Wenn type beispielsweise haltepunkt ist, enthält ExtraInformation eine DEBUG_LAST_EVENT_INFO_BREAKPOINT; wenn Type ausnahme ist, enthält ExtraInformation eine DEBUG_LAST_EVENT_INFO_EXCEPTION. Unter DEBUG_EVENT_XXX finden Sie die vollständige Liste der Ereignistypen und die Headerdatei dbgeng.h für die Strukturdefinitionen für jeden Ereignistyp.

Wenn ExtraInformationNULL ist, werden diese Informationen nicht zurückgegeben.

[in] ExtraInformationSize

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

[out, optional] ExtraInformationUsed

Empfängt die Größe der 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, den Die Beschreibung angibt. Diese Größe enthält den Platz für das "\0"-Endzeichen.

[out, optional] DescriptionUsed

Empfängt die Größe in Zeichen der Beschreibung des Ereignisses. Diese Größe enthält den Platz für das "\0"-Endzeichen. 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. Entweder ExtraInformationSize oder DescriptionSize waren jedoch kleiner, als die Größe der jeweiligen Daten oder Zeichenfolgen und die Daten oder Zeichenfolge abgeschnitten wurden, um in den Puffer zu passen.

Hinweise

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

Weitere Informationen zum letzten Ereignis finden Sie im Thema Ereignisinformationen.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (einschließlich Dbgeng.h)

Weitere Informationen

GetStoredEventInformation

IDebugControl4