IDebugDocumentPosition2::GetRange

获取此文档位置的范围。

语法

C#

int GetRange( 
   TEXT_POSITION[] pBegPosition,
   TEXT_POSITION[] pEndPosition
);

C++

HRESULT GetRange( 
   TEXT_POSITION* pBegPosition,
   TEXT_POSITION* pEndPosition
);

参数

pBegPosition
[in， out]用 起始位置填充的TEXT_POSITION 结构。 如果不需要此信息，请将此参数设置为 null 值。

pEndPosition
[in， out]用 结束位置填充的TEXT_POSITION 结构。 如果不需要此信息，请将此参数设置为 null 值。

返回值

如果成功，则返回 S_OK；否则，返回错误代码。

注解

调试引擎 （DE） 使用在位置断点的文档位置中指定的范围来搜索实际贡献代码的语句。 例如，考虑以下代码：

Line 5: // comment
Line 6: x = 1;

第 5 行不为正在调试的程序提供任何代码。 如果在第 5 行设置断点的调试器希望 DE 搜索贡献代码的第一行的一定数量，则调试器将指定一个范围，其中包含可能正确放置断点的其他候选行。 然后，DE 将搜索这些行，直到找到可以接受断点的行。

另请参阅

• IDebugDocumentPosition2
• TEXT_POSITION