SymGetModuleBase 함수(dbghelp.h)

지정된 주소를 포함하는 모듈의 기본 주소를 검색합니다.

구문

DWORD IMAGEAPI SymGetModuleBase(
  [in] HANDLE hProcess,
  [in] DWORD  dwAddr
);

매개 변수

[in] hProcess

원래 SymInitialize 함수에 전달된 프로세스에 대한 핸들입니다.

[in] dwAddr

SymLoadModule64 함수에 의해 로드된 모듈 중 하나에 포함된 가상 주소입니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 가상 주소입니다. 값은 dwAddr 매개 변수로 지정된 주소를 포함하는 모듈의 기본 주소입니다.

함수가 실패하면 반환 값은 0입니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.

설명

모듈 테이블은 dwAddr이 포함된 모듈을 검색합니다. 모듈은 각 모듈의 부하 주소 및 크기에 따라 배치됩니다.

이와 같은 모든 DbgHelp 함수는 단일 스레드입니다. 따라서 둘 이상의 스레드에서 이 함수로 호출하면 예기치 않은 동작이나 메모리 손상이 발생할 수 있습니다. 이를 방지하려면 둘 이상의 스레드에서 이 함수로의 모든 동시 호출을 동기화해야 합니다.

이 함수는 SymGetModuleBase 함수를 대체합니다. 자세한 내용은 업데이트된 플랫폼 지원을 참조하세요. SymGetModuleBase 는 DbgHelp.h에서 다음과 같이 정의됩니다.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetModuleBase SymGetModuleBase64
#else
DWORD
IMAGEAPI
SymGetModuleBase(
    __in HANDLE hProcess,
    __in DWORD dwAddr
    );
#endif

요구 사항

추가 정보

DbgHelp 함수

SymInitialize

SymLoadModule64