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

아티클
08/07/2023

GetModuleByOffset2 메서드는 프로세스의 모듈에서 메모리 할당에 지정된 위치가 포함된 모듈을 검색합니다.

구문

HRESULT GetModuleByOffset2(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

매개 변수

[in] Offset

원하는 모듈의 메모리 할당 내에 있는 대상의 가상 주소 공간(예: 모듈에 속하는 기호의 주소)의 위치를 지정합니다.

[in] StartIndex

검색을 시작할 인덱스를 지정합니다.

[in] Flags

지정된 위치로 모듈을 검색할 때 사용되는 옵션을 포함하는 비트 집합을 지정합니다. 플래그 에는 다음 비트 플래그가 포함될 수 있습니다.

플래그	효과
DEBUG_GETMOD_NO_LOADED_MODULES	로드된 모듈을 검색하지 마세요.
DEBUG_GETMOD_NO_UNLOADED_MODULES	언로드된 모듈을 검색하지 마세요.

[out, optional] Index

모듈의 인덱스를 받습니다. Index가 NULL이면 이 정보가 반환되지 않습니다.

[out, optional] Base

모듈 기반의 대상 메모리 주소 공간에 있는 위치를 수신합니다. Base가 NULL이면 이 정보가 반환되지 않습니다.

반환 값

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

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.

설명

지정된 인덱스부터 이 메서드는 메모리 할당 주소 범위에 지정된 위치가 포함된 첫 번째 모듈을 반환합니다. 대상에 메모리 주소 범위에 이 위치가 포함된 모듈이 두 개 이상 있는 경우 StartIndex 값이 더 높은 이 메서드를 반복적으로 호출하여 후속 모듈을 찾을 수 있습니다.

모듈에 대한 자세한 내용은 모듈을 참조하세요.