IDebugClient3::GetEventCallbacks メソッド (dbgeng.h)

[アーティクル]
08/07/2023

GetEventCallbacks メソッドは、このクライアントに登録されているイベントコールバックオブジェクトを返します。

構文

HRESULT GetEventCallbacks(
  [out] PDEBUG_EVENT_CALLBACKS *Callbacks
);

パラメーター

[out] Callbacks

このクライアントに登録されているイベントコールバックオブジェクトへのインターフェイスポインターを受け取ります。

戻り値

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

リターンコード	説明
S_OK	メソッドは正常に実行されました。

注釈

各クライアントは、イベントを受信するために、最大 1 つの IDebugEventCallbacks オブジェクトまたは IDebugEventCallbacksWideオブジェクトを登録できます。

クライアントにイベントコールバックオブジェクトが登録されていない場合、 Callbacks の値は NULL に設定されます。

IDebugEventCallbacks インターフェイスは、COM インターフェイス IUnknown を拡張します。 Callbacks で指定された IDebugEventCallbacks オブジェクトを返す前に、エンジンは IUnknown::AddRef メソッドを呼び出します。このオブジェクトが不要になったら、 その IUnknown::Release メソッドを呼び出す必要があります。

コールバックの詳細については、「コールバック」を参照してください。