다음을 통해 공유


IDataModelScriptDebugStackFrame::GetPosition 메서드(dbgmodel.h)

GetPosition 메서드는 스택 프레임이 나타내는 스크립트 내의 위치를 반환합니다. 이 메서드는 스크립트가 이 프레임이 포함된 스택이 나타내는 중단 내에 있는 경우에만 호출할 수 있습니다. 이 프레임 내의 선 및 열 위치는 항상 반환됩니다. 디버거가 스크립트 내에서 "실행 위치"의 범위를 반환할 수 있는 경우 positionSpanEnd 인수에서 끝 위치를 반환할 수 있습니다. 디버거가 이를 수행할 수 없는 경우 범위 끝의 줄 및 열 값(요청된 경우)을 0으로 설정해야 합니다.

이 프레임을 나타내는 텍스트 줄(또는 텍스트 범위)은 필요에 따라 이를 지원하는 디버거에 의해 다시 전달될 수 있습니다. 스크립트 디버거가 이 텍스트를 반환하기 위해 모든 시도를 하는 것이 좋지만, 이러한 디버거가 프레임의 선 및 열 위치보다 더 많은 것을 반환할 필요는 없습니다. 반환 텍스트가 지원되지 않는 경우 lineText 인수에서 nullptr을 반환할 수 있습니다.

구문

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

매개 변수

position

디버거는 이 인수에서 프레임의 선 및 열 위치를 채워야 합니다.

positionSpanEnd

호출자는 필요에 따라 nullptr이 아닌 값을 여기에 전달하여 이 스택 프레임을 나타내는 텍스트 범위의 끝을 요청할 수 있습니다. 디버거가 이러한 요청을 지원할 수 있는 경우 여기에서 줄 및 열 위치를 반환합니다. 그렇지 않으면 데이터 구조의 선 및 열 필드를 0으로 설정하여 값을 확인할 수 없음을 나타냅니다.

lineText

호출자는 필요에 따라 프레임 위치를 나타내는 소스 코드 줄(또는 범위)을 요청할 수 있습니다. 디버거가 이를 반환할 수 있는 경우 SysAllocString 함수에 의해 할당된 문자열과 같이 여기에 반환되어야 합니다. 호출자는 SysFreeString을 사용하여 할당된 문자열을 해제합니다. 디버거가 이를 반환할 수 없는 경우 nullptr이 여기에 반환되어야 합니다.

반환 값

이 메서드는 성공 또는 실패를 나타내는 HRESULT를 반환합니다.

요구 사항

요구 사항
헤더 dbgmodel.h

추가 정보

IDataModelScriptDebugStackFrame 인터페이스