IDebugClient5::SetEventCallbacksWide メソッド (dbgeng.h)

SetEventCallbacksWide メソッドは、このクライアントにイベント コールバック オブジェクトを登録します。

構文

HRESULT SetEventCallbacksWide(
  [in] PDEBUG_EVENT_CALLBACKS_WIDE Callbacks
);

パラメーター

[in] Callbacks

このクライアントに登録するイベント コールバック オブジェクトへのインターフェイス ポインターを指定します。

戻り値

Callbacks で指定されたオブジェクト内のメソッド IDebugEventCallbacks::GetInterestMask の実装によっては、「解説」セクションで説明されているように、他の値が返される場合があります。

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

注釈

Callbacks の値が NULL でない場合は、メソッド IDebugEventCallbacks::GetInterestMask が呼び出されます。 戻り値がS_OKされていない場合、 SetEventCallbacksSetEventCallbacksWide は無効であり、この値を返します。

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

IDebugEventCallbacksWide インターフェイスは、COM インターフェイス IUnknown を拡張します。 SetEventCallbacksSetEventCallbacksWide が成功すると、Callbacks で指定されたオブジェクトの IUnknown::AddRef メソッドを呼び出します。 このオブジェクトの IUnknown::Release メソッドは、このクライアントで次に SetEventCallbacks または SetEventCallbacksWide が呼び出されたとき、またはこのクライアントが削除されるときに呼び出されます。

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

要件

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

こちらもご覧ください

GetEventCallbacks

IDebugClient5

IDebugEventCallbacks