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 |