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

EndSession メソッドは、現在のデバッガーセッションを終了します。

構文

HRESULT EndSession(
  [in] ULONG Flags
);

[in] Flags

セッションを終了する方法を指定します。 フラグ には、次のいずれかの値を指定できます。

フラグ	説明
DEBUG_END_PASSIVE	セッションのクリーンアップを実行します。
DEBUG_END_ACTIVE_TERMINATE	セッションのクリーンアップを実行する前に、すべてのユーザーモードターゲットの終了を試みます。
DEBUG_END_ACTIVE_DETACH	セッションのクリーンアップを実行する前に、すべてのターゲットから切断を試みます。
DEBUG_END_REENTRANT	ロックの取得を必要としないクリーンアップのみを実行します。詳細については、「解説」セクションを参照してください。
DEBUG_END_DISCONNECT	セッションを終了しないでください。セッションからクライアントを切断し、クライアントを無効にします。このフラグは、リモートクライアントが切断されたときに使用されます。切断に関するサーバーメッセージが生成されます。

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

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

このメソッドは、 Flags が DEBUG_END_REENTRANT に設定された状態でいつでも呼び出されます。たとえば、アプリケーションを終了する必要があるが、別のスレッドがエンジンを使用している場合、このメソッドを使用してできるだけ多くのクリーンアップを実行できます。

DEBUG_END_REENTRANTを使用すると、エンジンが不確定状態になる可能性があります。このフラグを使用する場合は、エンジンに対して後続の呼び出しを行う必要はありません。

デバッガーセッションの詳細については、「セッションと実行モデルのデバッグ」を参照してください。

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