IDataModelScriptDebugBreakpoint：：GetPosition 方法 （dbgmodel.h）

GetPosition 方法返回脚本中断点的位置。 脚本调试器必须返回断点所在的源代码中的行和列。 如果它能够执行此作，则它还可以通过填写 positionSpanEnd 参数定义的结束位置来返回由断点表示的源范围。 如果调试器无法生成此范围，并且调用方请求它，则范围结束位置的“行”和“列”字段应填充为零，指示无法提供值。

调试器还可以返回在 lineText 参数中存在断点的源代码行（或范围）的文本。 虽然强烈建议调试器返回此值，但不是必需的。 只有源中的行和列位置是必需的返回值。 如果调试器无法生成源文本，则可能会在 lineText 参数中返回 nullptr。

语法

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

参数

position

必须在脚本的源代码中返回断点的行和列位置。

positionSpanEnd

如果调试器能够生成断点所表示的源范围，则可以返回此范围末尾的行和列位置。 否则，应将结构的“行”和“列”值设置为零，指示无法提供值。

lineText

如果调试器可以生成由断点表示的源代码行（或范围），它将返回此处，例如通过 SysAllocString 函数分配的字符串。 调用方负责通过 SysFreeString 释放返回的字符串。 如果调试器无法返回此源文本，则应在此处返回 nullptr。

返回值

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

要求

另请参阅

IDataModelScriptDebugBreakpoint 接口