Функция 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 |