Интерфейс IDataModelScriptDebug (dbgmodel.h)

2025-02-06

Основной интерфейс, предоставляемый поставщиком скриптов, чтобы сделать скрипт отладчиком. Класс реализации интерфейса IDataModelScript должен запрашивать ЗапросInterface для IDataModelScriptDebug, если скрипт можно отлаживать.

Любой скрипт, который можно отладить, указывает на эту возможность через наличие интерфейса IDataModelScriptDebug на том же компоненте, который реализует IDataModelScript. Запрос к этому интерфейсу узлом отладки или приложением отладчика, на котором размещена модель данных, указывает на наличие возможности отладки.

Наследство

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 возвращает, включено ли событие прерывания для определенного события.
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.

Замечания

Инфраструктура для поставщиков сценариев в модели данных также предоставляет концепцию для отладки скриптов. Любой скрипт, который хочет предоставить возможности отладки узлу отладки и приложению отладчика, в котором размещена модель данных, может сделать это, выполнив отладочные скрипты, реализуя интерфейс IDataModelScriptDebug в дополнение к интерфейсу IDataModelScript. Наличие этого интерфейса в скрипте указывает на инфраструктуру, которую можно отлаживать.

Хотя интерфейс IDataModelScriptDebug является отправной точкой для получения доступа к возможностям отладки поставщика скриптов, он присоединяется к набору других интерфейсов при предоставлении общих возможностей отладки.

IDataModelScriptDebug

IDataModelScriptDebugClient

IDataModelScriptDebugStack

IDataModelScriptDebugStackFrame

IDataModelScriptDebugVariableSetEnumerator

IDataModelScriptDebugBreakpoint

IDataModelScriptDebugBreakpointEnumerator