IDebugControl4::GetLastEventInformationWide 方法 (dbgeng.h)

GetLastEventInformationWide方法會傳回目標中最後一個事件的相關資訊。

語法

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
);

參數

[out] Type

接收目標所產生的最後一個事件種類。 如需可能的型別清單,請參閱 DEBUG_EVENT_XXX

[out] ProcessId

接收發生事件之進程的進程識別碼。 如果無法使用這項資訊,則會改為傳回DEBUG_ANY_ID。

[out] ThreadId

接收發生最後一個事件之執行緒的執行緒識別碼。 如果無法使用這項資訊,則會改為傳回DEBUG_ANY_ID。

[out, optional] ExtraInformation

接收事件的額外資訊。 此額外資訊的內容取決於傳回的 Type 參數所指出的事件種類。 例如,如果 Type 是中斷點, ExtraInformation 會包含DEBUG_LAST_EVENT_INFO_BREAKPOINT;如果 Type 是 Exception,ExtraInformation 會包含DEBUG_LAST_EVENT_INFO_EXCEPTION。 如需事件種類的完整清單,請參閱 DEBUG_EVENT_XXX ,以及每個事件種類的結構定義 dbgeng.h 標頭檔。

如果 ExtraInformationNull,則不會傳回此資訊。

[in] ExtraInformationSize

指定 ExtraInformation 所指定的緩衝區大小,以位元組為單位。

[out, optional] ExtraInformationUsed

接收額外資訊的大小,以位元組為單位。 如果 ExtraInformationUsedNull,則不會傳回此資訊。

[out, optional] Description

接收事件的描述。 如果 DescriptionNull,則不會傳回此資訊。

[in] DescriptionSize

指定 Description 所指定緩衝區的大小,以字元為單位。 此大小包含 '\0' 終止字元的空間。

[out, optional] DescriptionUsed

接收事件描述字元的大小。 此大小包含 '\0' 終止字元的空間。 如果 DescriptionUsed Null,則不會傳回這項資訊。

傳回值

這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值

傳回碼 描述
S_OK
此方法成功。
S_FALSE
此方法成功。 不過, ExtraInformationSizeDescriptionSize 小於個別資料或字串的大小,而資料或字串已截斷以符合緩衝區內。

備註

針對執行緒和進程建立事件,傳回至 ThreadId 和 ProcessId 的執行緒識別碼和 進程識別碼 是針對新建立的執行緒或進程。

如需最後一個事件的詳細資訊,請參閱 事件資訊主題。

需求

   
目標平臺 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

GetStoredEventInformation

IDebugControl4