IDebugControl3::GetLastEventInformation-Methode (dbgeng.h)

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.

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.

Anforderungen

Siehe auch

GetStoredEventInformation

IDebugControl-

IDebugControl2-

IDebugControl3-