Share via

MapAndLoad 함수(imagehlp.h)

  • 아티클

이미지를 매핑하고 매핑된 파일에서 데이터를 미리 로드합니다.

구문

BOOL IMAGEAPI MapAndLoad(
  [in]  PCSTR         ImageName,
  [in]  PCSTR         DllPath,
  [out] PLOADED_IMAGE LoadedImage,
  [in]  BOOL          DotDll,
  [in]  BOOL          ReadOnly
);

매개 변수

[in] ImageName

로드되는 이미지(실행 파일 또는 DLL)의 파일 이름입니다.

[in] DllPath

제공된 이름을 찾을 수 없는 경우 이미지를 찾는 데 사용되는 경로입니다. 이 매개 변수가 NULL이면 SearchPath 함수를 사용하여 설정된 검색 경로 규칙이 적용됩니다.

[out] LoadedImage

이미지를 로드한 후 이미지에 대한 정보를 수신하는 LOADED_IMAGE 구조체에 대한 포인터입니다.

[in] DotDll

이미지 이름에 파일 이름 확장명을 포함하지 않는 경우 사용할 기본 확장명입니다. 값이 TRUE이면 .DLL 확장이 사용됩니다. 값이 FALSE이면 .EXE 확장이 사용됩니다.

[in] ReadOnly

액세스 모드입니다. 이 값이 TRUE이면 파일은 읽기 액세스 전용으로 매핑됩니다. 값이 FALSE이면 파일은 읽기 및 쓰기 액세스에 매핑됩니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

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

설명

MapAndLoad 함수는 이미지를 매핑하고 매핑된 파일에서 데이터를 미리 로드합니다. 해당 함수 UnMapAndLoad는 MapAndLoad 함수에 의해 할당된 모든 리소스의 할당을 취소하는 데 사용해야 합니다.

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

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 imagehlp.h
라이브러리 Imagehlp.lib
DLL Imagehlp.dll

참고 항목

ImageHlp 함수

LOADED_IMAGE

UnMapAndLoad