IDebugClient4::D ispatchCallbacks メソッド (dbgeng.h)

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

DispatchCallbacks メソッドを使用すると、デバッガーエンジンはコールバックに現在のスレッドを使用できます。

構文

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

パラメーター

[in] Timeout

このメソッドが返されるまでの待機時間をミリ秒単位で指定します。 Timeout が INFINITE の場合、ExitDispatch が呼び出されるかエラーが発生するまで、このメソッドは戻りません。

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました (ExitDispatch が使用されました)。
S_FALSE	タイムアウト (ミリ秒) が経過しました。

注釈

このメソッドは、 タイムアウト (ミリ秒) が経過した場合、 ExitDispatch が呼び出された場合、またはエラーが発生した場合にを返します。

ほとんどすべてのクライアントメソッドは、クライアントが作成されたスレッドから呼び出す必要があります。クライアントに登録されているコールバックオブジェクトも、このスレッドから呼び出されます。 DispatchCallbacks が呼び出されると、エンジンは現在のスレッドを使用してコールバック呼び出しを行うことができます。

クライアントスレッドは、可能な限りこのメソッドを呼び出してコールバックの呼び出しを許可する必要があります。ただし、スレッドがデバッガーセッションの開始に使用されたスレッドと同じでない限り、 WaitForEvent が呼び出されたときにコールバックが呼び出されます。

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