次の方法で共有

IDebugControl3::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

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

[out] ThreadId

最後のイベントが発生したスレッドのスレッド インデックス (スレッド ID ではなく) を受け取ります。 この情報を使用できない場合は、代わりにDEBUG_ANY_IDが返されます。

[out, optional] ExtraInformation

イベントに関する追加情報を受け取ります。 この追加情報の内容は、イベントの種類によって異なります。 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 に返されるスレッド インデックスとプロセス ID と ProcessId は、新しく作成されたスレッドまたはプロセス用です。

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

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dbgeng.h (Dbgeng.h を含む)

関連項目

GetStoredEventInformation の

IDebugControl の

IDebugControl2 の

IDebugControl3 の