다음을 통해 공유


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

GetFunctionEntryByOffset 메서드는 함수에 대한 함수 항목 정보를 반환합니다.

통사론

HRESULT GetFunctionEntryByOffset(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BufferNeeded
);

매개 변수

[in] Offset

함수 구현의 현재 프로세스 가상 주소 공간에 있는 위치를 지정합니다. 이 값은 GetNextSymbolMatchIDebugSymbolGroup::GetSymbolOffsetOffset 매개 변수에 반환되는 값이며 DEBUG_SYMBOL_ENTRY 구조에서 Offset 필드의 값입니다.

[in] Flags

이 메서드의 동작을 변경하는 비트 플래그를 지정합니다. 비트 DEBUG_GETFNENT_RAW_ENTRY_ONLY 설정되지 않은 경우 엔진은 잘 알려진 사례에 대한 인공 항목을 제공합니다. 이 비트를 설정하면 인공 항목이 사용되지 않습니다.

[out, optional] Buffer

함수 항목 정보를 받습니다. 유효 프로세서가 x86이면 함수의 FPO_DATA 구조입니다. 다른 모든 아키텍처의 경우 해당 아키텍처에 대한 IMAGE_FUNCTION_ENTRY 구조입니다.

[in] BufferSize

버퍼 버퍼의 크기를 지정합니다.

[out, optional] BufferNeeded

함수 항목 정보의 크기를 지정합니다.

반환 값

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

반환 코드 묘사
S_OK
메서드가 성공했습니다.
S_FALSE
메서드가 성공했지만 버퍼가 함수 항목 정보를 저장할 만큼 충분히 크지 않아 정보가 잘렸습니다.
E_NOINTERFACE
오프셋 위치에 대한 함수 항목 정보를 찾을 수 없습니다.

발언

FPO_DATA 및 IMAGE_FUNCTION_ENTRY 구조는 DbgHelp.chm 파일의 Windows용 디버깅 도구에 포함된 "이미지 도움말 라이브러리"에 설명되어 있습니다.

참고 DbgHelp.chm에 설명된 "이미지 도움말 라이브러리" 및 "디버그 도움말 라이브러리"의 함수는 확장 또는 디버거 엔진 애플리케이션에서 호출해서는 안 됩니다.
 
기호에 대한 자세한 내용은 기호참조하세요.

요구 사항

요구
대상 플랫폼 바탕 화면
헤더 dbgeng.h(Dbgeng.h, Winnt.h 포함)

참고 항목

DEBUG_SYMBOL_ENTRY

GetNextSymbolMatch

IDebugSymbolGroup::GetSymbolOffset

IDebugSymbols3