IDebugClient3::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を使用すると、エンジンが不確定状態になる可能性があります。 このフラグを使用する場合は、エンジンに対して後続の呼び出しを行う必要はありません。
デバッガー セッションの詳細については、「 セッションと実行モデルのデバッグ」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |