IDataModelScriptDebugStackFrame::GetPosition 方法 (dbgmodel.h)
GetPosition 方法返回堆栈帧表示的脚本中的位置。 仅当脚本位于包含此帧的堆栈表示的中断内时,才能调用此方法。 始终返回此帧中的线条和列位置。 如果调试器能够返回脚本中“执行位置”的跨度,则可以在 positionSpanEnd 参数中返回结束位置。 如果调试器无法执行此操作,则范围末尾的行和列值 (如果请求) 应设置为零。
(的文本行或表示此框架的文本) 范围,可以选择由支持它的调试器传递回来。 虽然强烈建议脚本调试器尝试返回此文本,但此类调试器返回的行和列位置不超出帧的行和列位置。 如果不支持返回文本,则可以在 lineText 参数中返回 nullptr。
语法
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
参数
position
调试器应填充此参数中帧的行和列位置。
positionSpanEnd
调用方可以选择通过在此处传递非 nullptr 值来请求表示此堆栈帧的文本范围的结束。 如果调试器可以支持此类请求,则返回此处的行和列位置;否则,数据结构的“行”和“列”字段应设置为零,指示无法确定值。
lineText
调用方可以选择性地请求源代码行 (或表示帧位置的跨度) 。 如果调试器能够返回此值,则它应在此处返回由 SysAllocString 函数分配的字符串。 调用方负责使用 SysFreeString 释放分配的字符串。 如果调试器无法返回此值,则应在此处返回 nullptr。
返回值
此方法返回指示成功或失败的 HRESULT。
要求
要求 | 值 |
---|---|
Header | dbgmodel.h |