Поделиться через


Функция ImageLoad (imagehlp.h)

Поддерживает список загруженных библиотек DLL.

Синтаксис

PLOADED_IMAGE IMAGEAPI ImageLoad(
  [in] PCSTR DllName,
  [in] PCSTR DllPath
);

Параметры

[in] DllName

Имя изображения.

[in] DllPath

Путь, используемый для поиска изображения, если не удается найти предоставленное имя. Если используется значение NULL , применяются правила пути поиска, заданные в функции SearchPath .

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение является указателем на структуру LOADED_IMAGE .

Если функция завершается сбоем, возвращается значение NULL. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

Функция ImageLoad используется для поддержки списка загруженных библиотек DLL. Если образ уже загружен, возвращается предыдущее LOADED_IMAGE . В противном случае новый образ добавляется в список.

Структура LOADED_IMAGE должна быть освобождена функцией ImageUnload .

Все функции ImageHlp, такие как эта, являются однопоточными. Поэтому вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imagehlp.h
Библиотека Imagehlp.lib
DLL Imagehlp.dll

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

Функции ImageHlp

ImageUnload

LOADED_IMAGE