IDataModelScriptDebug インターフェイス (dbgmodel.h)

[アーティクル]
08/07/2023

スクリプトをデバッグ可能にするためにスクリプトプロバイダーが提供する必要があるコアインターフェイス。スクリプトがデバッグ可能な場合、 IDataModelScript インターフェイスの実装クラスでは、IDataModelScriptDebug の QueryInterface が必要です。

デバッグ可能なスクリプトは、 IDataModelScript を実装する同じコンポーネントに IDataModelScriptDebug インターフェイスが存在する場合に、この機能を示します。デバッグホストまたはデータモデルをホストするデバッガーアプリケーションによるこのインターフェイスのクエリは、デバッグ機能の存在を示します。

継承

IDataModelScriptDebug は IUnknown から継承します。

メソッド

IDataModelScriptDebug インターフェイスには、これらのメソッドがあります。


IDataModelScriptDebug::AddRef IDataModelScriptDebug::AddRef メソッドは、オブジェクトのインターフェイスの参照カウントをインクリメントします。
IDataModelScriptDebug::EnumerateBreakpoints IDataModelScriptDebug::EnumerateBreakpoints メソッドは、スクリプトデバッガーが有効になっているときにすべてのブレークポイントを列挙できる列挙子を返します。
IDataModelScriptDebug::FindBreakpointById SetBreakpoint メソッドを使用してスクリプト内に作成された各ブレークポイントには、実装によって一意識別子 (64 ビット符号なし整数) が割り当てられます。
IDataModelScriptDebug::GetCurrentPosition IDataModelScriptDebug::GetCurrentPosition メソッドは、スクリプトデバッガーセッションの現在の中断位置を返します。
IDataModelScriptDebug::GetDebugState GetDebugState メソッドは、スクリプトの現在の状態 (実行中かどうかに関係なく) を返します。
IDataModelScriptDebug::GetEventFilter IDataModelScriptDebug::GetEventFilter メソッドは、特定のイベントに対して break-on-event が有効になっているかどうかを返します。
IDataModelScriptDebug::GetStack IDataModelScriptDebug::GetStack メソッドは、スクリプトデバッガーセッションの中断位置にある現在の呼び出し履歴を取得します。
IDataModelScriptDebug::QueryInterface IDataModelScriptDebug::QueryInterface メソッドは、オブジェクトでサポートされているインターフェイスへのポインターを取得します。
IDataModelScriptDebug::Release IDataModelScriptDebug::Release メソッドは、オブジェクト上のインターフェイスの参照カウントをデクリメントします。
IDataModelScriptDebug::SetBreakpoint IDataModelScriptDebug::SetBreakpoint メソッドは、スクリプトデバッガーが有効になっているときにスクリプト内にブレークポイントを設定します。
IDataModelScriptDebug::SetEventFilter IDataModelScriptDebug::SetEventFilter メソッドは、特定のイベントのイベント中断動作を変更します。
IDataModelScriptDebug::StartDebugging IDataModelScriptDebug::StartDebugging メソッドは、特定のスクリプトのデバッガーをオンにしますが、実行の中断やステップ実行は開始しません。
IDataModelScriptDebug::StopDebugging IDataModelScriptDebug::StopDebugging メソッドは、StartDebugging メソッドが正常に呼び出された後にデバッグアクティビティを停止します。

注釈

データモデルのスクリプトプロバイダーのインフラストラクチャには、スクリプトのデバッグに関する概念も用意されています。デバッグ機能をデバッグホストとデータモデルをホストするデバッガーアプリケーションに公開するスクリプトは、デバッグ可能なスクリプトに IDataModelScript インターフェイスに加えて IDataModelScriptDebug インターフェイスを実装することで、これを行うことができます。スクリプトにこのインターフェイスが存在することは、デバッグ可能であることをインフラストラクチャに示します。

IDataModelScriptDebug インターフェイスは、スクリプトプロバイダーのデバッグ機能にアクセスするための開始点ですが、全体的なデバッグ機能を提供する際に他のインターフェイスのセットによって結合されます。

IDataModelScriptDebug

IDataModelScriptDebugClient

IDataModelScriptDebugStack

IDataModelScriptDebugStackFrame

IDataModelScriptDebugVariableSetEnumerator

IDataModelScriptDebugBreakpoint

IDataModelScriptDebugBreakpointEnumerator