IDebugSymbols2::GetLineByOffset 메서드(dbgeng.h)

아티클
08/07/2023

GetLineByOffset 메서드는 대상에 있는 명령의 원본 파일 내에서 소스 파일 이름과 줄 번호를 반환합니다.

구문

HRESULT GetLineByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PULONG   Line,
  [out, optional] PSTR     FileBuffer,
  [in]            ULONG    FileBufferSize,
  [out, optional] PULONG   FileSize,
  [out, optional] PULONG64 Displacement
);

매개 변수

[in] Offset

원본 파일 및 줄 번호를 반환할 명령의 대상 가상 주소 공간에 있는 위치를 지정합니다.

[out, optional] Line

Offset으로 지정된 명령의 원본 파일 내에서 줄 번호를 받습니다. Line이 NULL이면 이 정보가 반환되지 않습니다.

[out, optional] FileBuffer

Offset에서 지정한 명령이 포함된 파일의 파일 이름을 받 습니다. FileBuffer가 NULL이면 이 정보가 반환되지 않습니다.

[in] FileBufferSize

FileBuffer 버퍼의 크기를 문자 단위로 지정합니다.

[out, optional] FileSize

원본 파일 이름의 크기를 문자 단위로 지정합니다. FileSize가 NULL이면 이 정보가 반환되지 않습니다.

[out, optional] Displacement

Offset에 지정된 위치와 반환된 줄의 첫 번째 명령 위치 간의 차이를 받습니다. Displacement가 NULL이면 이 정보가 반환되지 않습니다.

반환 값

이 메서드는 다른 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값을 참조하세요.

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 버퍼가 원본 파일의 이름을 저장할 만큼 크지 않았고 이름이 잘렸습니다.