IDebugControl3::GetLastEventInformation メソッド (dbgeng.h)

[アーティクル]
02/26/2024

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 のどちらかが小さかったのは、それぞれのデータまたは文字列のサイズとデータまたは文字列のサイズがバッファー内に収まるように切り捨てられました。