Функция 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
Header imagehlp.h
Библиотека Imagehlp.lib
DLL Imagehlp.dll

См. также раздел

Функции ImageHlp

LOADED_IMAGE

UnMapAndLoad