IDebugControl3::GetLastEventInformation-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetLastEventInformation-Methode gibt Informationen zum letzten 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 zum Ereignis. Der Inhalt dieser zusätzlichen Informationen hängt vom Typ des Ereignisses ab. 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 Description angibt. Diese Größe enthält den Leerraum 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 Leerraum für das "\0"-Endzeichen. Wenn DescriptionUsed null ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Allerdings waren entweder ExtraInformationSize oder DescriptionSize 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 gelten der Threadindex 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.