IDebugSymbols3::GetSourceFileLineOffsets 메서드(dbgeng.h)

아티클
02/06/2022
읽는 데 2분 걸림

GetSourceFileLineOffsets 메서드는 원본 파일의 각 줄을 대상 메모리의 위치에 매핑합니다.

구문

HRESULT GetSourceFileLineOffsets(
  [in]            PCSTR    File,
  [out, optional] PULONG64 Buffer,
  [in]            ULONG    BufferLines,
  [out, optional] PULONG   FileLines
);

매개 변수

[in] File

줄이 대상 메모리의 위치로 바뀌는 파일의 이름을 지정합니다. 대상의 각 모듈에 대한 기호는 이 파일에 대해 쿼리됩니다. 파일이 없으면 경로가 삭제되고 기호가 다시 쿼리됩니다.

[out, optional] Buffer

소스 코드 줄에 해당하는 대상 메모리의 위치를 받습니다. 이 배열에 반환된 첫 번째 항목은 파일의 첫 번째 줄에 해당하므로 줄i+1의 위치가 Buffer[i] 포함됩니다. 줄에 사용할 수 있는 기호 정보가 없으면 버퍼 의 해당 항목이 DEBUG_INVALID_OFFSET 설정됩니다. 버퍼가 NULL이면 이 정보가 반환되지 않습니다.

[in] BufferLines

버퍼 배열에서 보유할 수 있는 PULONG64 개체의 수를 지정합니다.

[out, optional] FileLines

파일에서 지정한 소스 파일의 줄 수를 받습니다.

반환 값

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

반환 코드	설명
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 원본 파일의 줄 수가 버퍼 배열의 항목 수를 초과했으며 일부 결과가 삭제되었습니다.