IDebugControl2::GetLastEventInformation 方法 (dbgeng.h)
GetLastEventInformation 方法會傳回目標中最後一個事件的相關信息。
語法
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
);
參數
[out] Type
接收目標所產生的最後一個事件類型。 如需可能的型別清單,請參閱 DEBUG_EVENT_XXX。
[out] ProcessId
接收發生事件之進程的進程標識碼。 如果無法使用這項資訊,則會改為傳回DEBUG_ANY_ID。
[out] ThreadId
接收發生最後一個事件之線程的線程索引(而非線程標識符)。 如果無法使用這項資訊,則會改為傳回DEBUG_ANY_ID。
[out, optional] ExtraInformation
接收事件的額外資訊。 此額外資訊的內容取決於事件的類型。 如果 ExtraInformationNULL,則不會傳回此資訊。
[in] ExtraInformationSize
指定 ExtraInformation 指定之緩衝區的大小,以位元組為單位。
[out, optional] ExtraInformationUsed
接收額外資訊的大小,以位元組為單位。 如果 ExtraInformationUsedNULL,則不會傳回此資訊。
[out, optional] Description
接收事件的描述。 如果 描述NULL,則不會傳回此資訊。
[in] DescriptionSize
指定 Description 所指定之緩衝區的大小,以字元為單位。 此大小包含 『\0』 終止字元的空間。
[out, optional] DescriptionUsed
接收事件描述的字元大小。 此大小包含 『\0』 終止字元的空間。 如果 DescriptionUsed NULL,則不會傳回此資訊。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
|
方法成功。 不過,ExtraInformationSize 或 DescriptionSize 小於個別數據或字串的大小,而且數據或字符串已截斷以符合緩衝區內。 |
言論
針對線程和進程建立事件,傳回至 ThreadId 和 ProcessId 的線程索引和進程標識碼是針對新建立的線程或進程。
如需最後一個事件的詳細資訊,請參閱 事件資訊主題。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h) |