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

아티클
08/07/2023

GetOffsetByName 메서드는 이름으로 식별된 기호의 위치를 반환합니다.

구문

HRESULT GetOffsetByName(
  [in]  PCSTR    Symbol,
  [out] PULONG64 Offset
);

매개 변수

[in] Symbol

찾을 기호의 이름을 지정합니다. 이름은 모듈 이름(예: mymodule!기본)으로 한정될 수 있습니다.

[out] Offset

기호의 메모리 할당 기준의 대상 메모리 주소 공간에 있는 위치를 받습니다.

반환 값

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

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 기호 이름이 고유하지 않으며 해당 이름의 여러 기호가 발견되었습니다. 이러한 기호 중 하나가 임의로 선택되어 반환되었습니다.
E_FAIL	지정된 이름을 가진 기호를 찾을 수 없습니다.

설명

이름 기호가 고유하지 않고 GetOffsetByName이 해당 이름의 여러 기호를 찾으면 모호성이 임의로 해결됩니다. 이 경우 S_FALSE 값이 반환됩니다. StartSymbolMatch 를 사용하여 검색을 시작하여 원하는 결과를 확인할 수 있습니다.

GetNameByOffset 은 패턴 일치(예: 와일드카드)를 지원하지 않습니다. 패턴 일치를 사용하여 기호를 찾으려면 StartSymbolMatch를 사용합니다.

기호의 모듈 이름이 알려진 경우 기호 이름을 모듈 이름으로 한정하는 것이 가장 좋습니다. 그렇지 않으면 엔진이 일치하는 항목을 발견할 때까지 모든 모듈에 대한 기호를 검색합니다. 많은 모듈에 대한 기호 파일을 로드해야 하는 경우 시간이 오래 걸릴 수 있습니다. 기호 이름이 모듈 이름으로 한정된 경우 엔진은 해당 모듈에 대한 기호만 검색합니다.

기호 및 기호 이름에 대한 자세한 내용은 기호를 참조하세요.