IDataModelScriptDebugStackFrame::GetPosition 方法 (dbgmodel.h)

GetPosition 方法返回堆栈帧所表示的脚本中的位置。 仅当脚本位于包含此帧的堆栈所表示的中断中时,才能调用此方法。 始终返回此帧中的行和列位置。 如果调试器能够返回脚本中“执行位置”的跨度,则可以在 positionSpanEnd 参数中返回结束位置。 如果调试器无法执行此作,范围末尾的行和列值(如果请求)应设置为零。

表示此框架的文本行(或文本范围)可以选择由支持它的调试器传回。 虽然强烈建议脚本调试器每次尝试返回此文本,但不需要此类调试器返回的行和列位置超过帧的行和列位置。 如果不支持返回文本,则可以在 lineText 参数中返回 nullptr。

语法

HRESULT GetPosition(
  ScriptDebugPosition *position,
  ScriptDebugPosition *positionSpanEnd,
  BSTR                *lineText
);

参数

position

调试器应在此参数中填充框架的行和列位置。

positionSpanEnd

调用方可以通过在此处传递非 nullptr 值来请求表示此堆栈帧的文本范围的结束。 如果调试器可以支持此类请求,它将返回此处的行和列位置;否则,数据结构的“行”和“列”字段应设置为零,指示无法确定值。

lineText

调用方可以选择请求表示帧位置的源代码行(或范围)。 如果调试器能够返回此项,则应返回此处,例如 SysAllocString 函数分配的字符串。 调用方负责使用 SysFreeString 释放分配的字符串。 如果调试器无法返回此值,则应在此处返回 nullptr。

返回值

此方法返回 HRESULT,指示成功或失败。

要求

要求 价值
标头 dbgmodel.h

另请参阅

IDataModelScriptDebugStackFrame 接口