MapDebugInformation 함수(dbghelp.h)

아티클
03/09/2024

이미지에 대한 디버깅 정보에 대한 액세스 권한을 얻습니다.

참고 이 함수는 이전 버전과의 호환성을 위해서만 제공됩니다. 신뢰할 수 있는 정보를 반환하지 않습니다. 새 애플리케이션은 SymGetModuleInfo64 및 SymLoadModule64 함수를 사용해야 합니다.

구문

PIMAGE_DEBUG_INFORMATION IMAGEAPI MapDebugInformation(
  [in, optional] HANDLE FileHandle,
  [in]           PCSTR  FileName,
  [in, optional] PCSTR  SymbolPath,
  [in]           ULONG  ImageBase
);

매개 변수

[in, optional] FileHandle

열려 있는 실행 파일 이미지 또는 NULL에 대한 핸들입니다.

[in] FileName

실행 파일 또는 NULL의 이름입니다.

[in, optional] SymbolPath

기호 파일이 있는 경로입니다. 경로는 세미콜론으로 구분된 여러 경로일 수 있습니다. 기호 경로를 검색하려면 SymGetSearchPath 함수를 사용합니다.

[in] ImageBase

이미지의 기본 주소 또는 0입니다.

반환 값

함수가 성공하면 반환 값은 IMAGE_DEBUG_INFORMATION 구조체에 대한 포인터입니다.

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

설명

MapDebugInformation 함수는 이미지의 디버깅 정보에 대한 액세스 권한을 얻는 데 사용됩니다. 디버깅 정보는 이미지 또는 기호 파일에서 추출되어 IMAGE_DEBUG_INFORMATION 구조체에 배치됩니다. 이 구조체는 라이브러리에 의해 할당되며 UnmapDebugInformation 함수를 사용하여 할당을 취소해야 합니다. 구조체의 메모리가 프로세스의 기본 힙에 없으므로 메모리 할당 취소 루틴으로 해제하려고 하면 실패합니다.

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