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

아티클
02/23/2024

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

구문

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

매개 변수

[in] Offset

함수 구현의 현재 프로세스 가상 주소 공간에 있는 위치를 지정합니다. GetNextSymbolMatch 및 IDebugSymbolGroup::GetSymbolOffset의 Offset 매개 변수에 반환된 값과 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

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

반환 값

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

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