IDebugClient2::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 |
セッションを終了しないでください。 セッションからクライアントを切断し、クライアントを無効にします。
このフラグは、リモート クライアントが切断されたときに使用されます。 切断に関するサーバー メッセージが生成されます。 |
戻り値
このメソッドは、エラー値を返す場合もあります。 詳細については 戻り値の を参照してください。
リターン コード | 形容 |
---|---|
|
メソッドが成功しました。 |
備考
このメソッドは、Flags を DEBUG_END_REENTRANT に設定して、いつでも呼び出されます。 たとえば、アプリケーションを終了する必要があるが、別のスレッドがエンジンを使用している場合、このメソッドを使用してできるだけ多くのクリーンアップを実行できます。
DEBUG_END_REENTRANTを使用すると、エンジンが不確定な状態になる可能性があります。 このフラグを使用する場合は、後続の呼び出しをエンジンに対して行う必要はありません。
デバッガー セッションの詳細については、「デバッグ セッションと実行モデルの 」を参照してください。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | dbgeng.h (Dbgeng.h を含む) |