IDebugAdvanced3::GetSourceFileInformation 메서드(dbgeng.h)

아티클
02/26/2024

GetSourceFileInformation 메서드는 원본 파일에 대한 지정된 정보를 반환합니다.

구문

HRESULT GetSourceFileInformation(
  [in]            ULONG   Which,
  [in]            PSTR    SourceFile,
  [in]            ULONG64 Arg64,
  [in]            ULONG   Arg32,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

매개 변수

[in] Which

반환할 정보 부분을 지정합니다. 다음 표의 값 중 하나를 사용할 수 있는 매개 변수입니다.

DEBUG_SRCFILE_SYMBOL_TOKEN

원본 서버에서 지정된 원본 파일을 나타내는 토큰을 반환합니다. 이 토큰을 FindSourceFileAndToken 에 전달하여 파일에 대한 정보를 검색할 수 있습니다. 토큰은 버퍼 버퍼 에 바이트 배열로 반환됩니다. 이 토큰의 크기는 SrcSrv 토큰 크기를 반영한 것입니다.

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

원본 서버에서 명령을 쿼리하여 소스 제어에서 원본 파일을 추출합니다. 여기에는 실행 파일의 이름과 명령줄 매개 변수가 포함됩니다. 명령은 버퍼 버퍼 에 유니코드 문자열로 반환됩니다.

[in] SourceFile

정보가 요청되는 원본 파일을 지정합니다. 원본 파일은 원본 경로의 모든 원본 서버에서 조회됩니다.

[in] Arg64

64비트 인수를 지정합니다. 값은 기호 토큰이 요청된 모듈을 지정합니다. 값에 관계없이 Arg64는 모듈의 메모리 할당 내 위치입니다.

[in] Arg32

32비트 인수를 지정합니다. 이 매개 변수는 현재 사용되지 않습니다.

[out, optional] Buffer

요청된 기호 정보를 받습니다. 반환되는 데이터의 형식은 값에 따라 달라집니다. Buffer가 NULL이면 이 정보가 반환되지 않습니다.

[in] BufferSize

버퍼 버퍼의 크기(바이트)를 지정합니다. 버퍼가 NULL인 경우 BufferSize도 NULL이어야 합니다.

[out, optional] InfoSize

버퍼 버퍼에 반환된 정보의 크기(바이트)를 지정합니다. 데이터가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

반환 값

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

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 정보가 버퍼 버퍼 에 맞지 않으므로 정보 또는 이름이 잘렸습니다.

설명

원본 파일에 대한 자세한 내용은 원본 파일 사용을 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	dbgeng.h(Dbgeng.h 포함)

추가 정보

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3

다음을 통해 공유