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

아티클
02/23/2024

GetNameByOffset 메서드는 대상의 가상 주소 공간에서 지정된 위치에 있는 기호의 이름을 반환합니다.

구문

HRESULT GetNameByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Displacement
);

매개 변수

[in] Offset

이름이 요청된 기호의 대상 가상 주소 공간에 있는 위치를 지정합니다. 오프셋 은 기호의 기본 위치를 지정할 필요가 없습니다. 기호의 메모리 할당 내에서 위치를 지정하기만 하면됩니다.

[out, optional] NameBuffer

기호의 이름을 받습니다. 이름은 기호가 속한 모듈(예: mymodule!기본)에 의해 정규화됩니다. NameBuffer가 NULL이면 이 정보가 반환되지 않습니다.

[in] NameBufferSize

버퍼 NameBuffer의 문자 크기를 지정합니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다.

[out, optional] NameSize

기호 이름의 문자로 크기를 받습니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다. NameSize가 NULL이면 이 정보가 반환되지 않습니다.

[out, optional] Displacement

Offset 값과 기호의 기본 위치 간의 차이를 받습니다. Displacement가 NULL이면 이 정보가 반환되지 않습니다.

반환 값

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

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 버퍼가 기호의 이름을 저장할 만큼 크지 않아 잘렸습니다.
E_FAIL	지정된 위치에서 기호를 찾을 수 없습니다.