Share via

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

イベントが発生したプロセスのプロセス ID を受け取ります。 この情報が使用できない場合は、代わりにDEBUG_ANY_IDが返されます。

[out] ThreadId

最後のイベントが発生したスレッドのスレッド ID を受け取ります。 この情報が使用できない場合は、代わりに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 ヘッダー ファイルを参照してください。

ExtraInformation が NULL の場合、この情報は返されません。

[in] ExtraInformationSize

ExtraInformation が指定するバッファーのサイズをバイト単位で指定します。

[out, optional] ExtraInformationUsed

追加情報のサイズ (バイト単位) を受け取ります。 ExtraInformationUsed が NULL の場合、この情報は返されません。

[out, optional] Description

イベントの説明を受け取ります。 Description が NULL の場合、この情報は返されません。

[in] DescriptionSize

Description が指定するバッファーのサイズを文字数で指定します。 このサイズには、'\0' 終端文字のスペースが含まれます。

[out, optional] DescriptionUsed

イベントの説明のサイズを文字数で受け取ります。 このサイズには、'\0' 終端文字のスペースが含まれます。 DescriptionUsed が NULL の場合、この情報は返されません。

戻り値

このメソッドは、エラー値を返す場合もあります。 詳細については、「 戻り値 」を参照してください。

リターン コード 説明
S_OK
 メソッドは正常に実行されました。
S_FALSE
 メソッドは正常に実行されました。 ただし、 ExtraInformationSize または DescriptionSize のどちらかが小さかったのは、それぞれのデータまたは文字列のサイズとデータまたは文字列のサイズがバッファー内に収まるように切り捨てられました。

注釈

スレッドとプロセスの作成イベントの場合、 ThreadId と ProcessId に返されるスレッド ID と プロセス ID は、新しく作成されたスレッドまたはプロセス用です。

最後のイベントの詳細については、トピック「 イベント情報」を参照してください。

要件

要件 値
対象プラットフォーム デスクトップ
Header dbgeng.h (Dbgeng.h を含む)

こちらもご覧ください

GetStoredEventInformation

IDebugControl4