IDataModelScriptDebugBreakpoint::GetPosition 方法 (dbgmodel.h)
GetPosition 方法返回断点在脚本中的位置。 脚本调试器必须在源代码中返回断点所在的行和列。 如果能够这样做,它还可以通过填写由 positionSpanEnd 参数定义的结束位置来返回由断点表示的源范围。 如果调试器无法生成此范围,并且调用方请求它,则范围结束位置的“行”和“列”字段应填充为零,指示无法提供值。
调试器还可以返回行的文本 (或范围) 的源代码,其中断点存在于 lineText 参数中。 虽然强烈建议调试器返回此值,但这不是必需的。 只有源中的行和列位置是必需的返回值。 如果调试器无法生成源文本,可能会在 lineText 参数中返回 nullptr。
语法
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
参数
position
必须在此处返回脚本源代码中断点的行和列位置。
positionSpanEnd
如果调试器能够生成由断点表示的源范围,则可以在此处返回范围末尾的行和列位置。 否则,结构的“行”和“列”值应设置为零,表示无法提供这些值。
lineText
如果调试器可以生成 (或跨断点表示的源代码) 行,则它在此处返回类似通过 SysAllocString 函数分配的字符串。 调用方负责通过 SysFreeString 释放返回的字符串。 如果调试器无法返回此源文本,则应在此处返回 nullptr。
返回值
此方法返回指示成功或失败的 HRESULT。
要求
要求 | 值 |
---|---|
Header | dbgmodel.h |