Функция LoadLibraryExA (libloaderapi.h)

Процесс вызова может использовать дескриптор, возвращенный LoadLibraryEx для идентификации модуля в вызовах GetProcAddress, FindResourceи функции LoadResource.

Чтобы включить или отключить сообщения об ошибках, отображаемые загрузчиком во время загрузки DLL, используйте функцию SetErrorMode.

Небезопасно вызывать LoadLibraryEx из DllMain. Дополнительные сведения см. в разделе "Примечания" в DllMain.

Visual C++: компилятор Visual C++ поддерживает синтаксис, позволяющий объявлять локальные переменные потока: _declspec(thread). Если этот синтаксис используется в библиотеке DLL, вы не сможете явно загрузить библиотеку DLL с помощью LoadLibraryEx в версиях Windows до Windows Vista. Если библиотека DLL будет загружена явным образом, необходимо использовать функции локального хранилища потока вместо _declspec(thread). Пример см. в разделе Использование локального хранилища потоков вбиблиотеки динамических ссылок.

загрузка библиотеки DLL в виде файла данных или ресурса изображения

Если LoadLibraryEx вызывается дважды для одного файла с LOAD_LIBRARY_AS_DATAFILE, LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVEили LOAD_LIBRARY_AS_IMAGE_RESOURCE, для файла создаются два отдельных сопоставления.

При использовании значения LOAD_LIBRARY_AS_IMAGE_RESOURCE модуль загружается в виде изображения с помощью расширения выравнивания разделов переносимого исполняемого файла (PE). Относительные виртуальные адреса (RVA) не нужно сопоставлять с адресами дисков, поэтому ресурсы можно быстрее извлекать из модуля. Указание LOAD_LIBRARY_AS_IMAGE_RESOURCE запрещает другим процессам изменять модуль во время загрузки.

Если приложение не зависит от конкретных характеристик сопоставления изображений, значение LOAD_LIBRARY_AS_IMAGE_RESOURCE должно использоваться либо с LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE, либо с LOAD_LIBRARY_AS_DATAFILE. Это позволяет загрузчику выбрать, следует ли загружать модуль в качестве ресурса изображения или файла данных, выбрав любой параметр, позволяющий системе предоставлять доступ к страницам более эффективно. Функции ресурсов, такие как FindResource, могут использовать любое сопоставление.

Чтобы определить, как был загружен модуль, используйте один из следующих макросов для проверки дескриптора, возвращаемого LoadLibraryEx.

#define LDR_IS_DATAFILE(handle)      (((ULONG_PTR)(handle)) &  (ULONG_PTR)1)
#define LDR_IS_IMAGEMAPPING(handle)  (((ULONG_PTR)(handle)) & (ULONG_PTR)2)
#define LDR_IS_RESOURCE(handle)      (LDR_IS_IMAGEMAPPING(handle) || LDR_IS_DATAFILE(handle))

В следующей таблице описаны эти макросы.

Используйте функцию FreeLibrary, чтобы освободить загруженный модуль, независимо от того, была ли загрузка модуля вызвана добавочным числом ссылок. Если модуль был загружен в виде файла данных или изображения, сопоставление уничтожается, но количество ссылок не уменьшается. В противном случае число ссылок dll уменьшается. Поэтому вызов FreeLibrary с любым дескриптором, возвращаемым LoadLibraryEx.

поиск библиотек DLL и зависимостей

Функция LoadLibraryEx использует стандартный путь поиска в следующих случаях:

• Имя файла указано без пути, а имя базового файла не совпадает с именем базового файла загруженного модуля, и ни один из флагов LOAD_LIBRARY_SEARCH не используется.
• Указан путь, но LOAD_WITH_ALTERED_SEARCH_PATH не используется.
• Приложение не указало путь поиска библиотеки DLL по умолчанию для процесса с помощью SetDefaultDllDirectory.

Если lpFileName указывает относительный путь, весь относительный путь добавляется к каждому токену в пути поиска DLL. Чтобы загрузить модуль из относительного пути без поиска другого пути, используйте GetFullPathName для получения нерелятивного пути и вызова LoadLibraryEx с нерелятивным путем. Если модуль загружается в виде файла данных, а относительный путь начинается с "." или ".", относительный путь рассматривается как абсолютный путь.

Если lpFileName указывает абсолютный путь и dwFlags задано значение LOAD_WITH_ALTERED_SEARCH_PATH, LoadLibraryEx использует измененный путь поиска. Поведение не определено при установке флага LOAD_WITH_ALTERED_SEARCH_PATH и lpFileName указывает относительный путь.

Функцию SetDllDirectory можно использовать для изменения пути поиска. Это решение лучше, чем использовать SetCurrentDirectory или жестко закодировать полный путь к библиотеке DLL. Однако помните, что использование SetDllDirectory эффективно отключает безопасный режим поиска DLL, пока указанный каталог находится в пути поиска, и он не является потокобезопасным. По возможности рекомендуется использовать AddDllDirectory для изменения пути поиска по умолчанию. Дополнительные сведения см. в Dynamic-Link порядке поиска библиотеки.

Приложение может указать каталоги для поиска одного вызова LoadLibraryEx с помощью флагов LOAD_LIBRARY_SEARCH_** . Если задано несколько флагов LOAD_LIBRARY_SEARCH, каталоги выполняются в следующем порядке:

• Каталог, содержащий библиотеку DLL (LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR). Этот каталог выполняется поиск только для зависимостей библиотеки DLL для загрузки.
• Каталог приложения (LOAD_LIBRARY_SEARCH_APPLICATION_DIR).
• Пути явно добавлены в путь поиска приложения с функцией AddDllDirectory (LOAD_LIBRARY_SEARCH_USER_DIRS) или функцией setDllDirectory SetDllDirectory. Если добавлено несколько путей, порядок поиска путей не определен.
• Каталог System32 (LOAD_LIBRARY_SEARCH_SYSTEM32).

Windows 7, Windows Server 2008 R2, Windows Vista и Windows Server 2008: Флаги LOAD_LIBRARY_SEARCH_ доступны в системах с установленными KB2533623. Чтобы определить, доступны ли флаги, используйте GetProcAddress для получения адреса AddDllDirectory, RemoveDllDirectoryили Функции SetDefaultDllDirectory. Если GetProcAddress успешно, флаги LOAD_LIBRARY_SEARCH_ можно использовать с LoadLibraryEx.

Если приложение использовало функцию SetDefaultDllDirectory для установки пути поиска библиотеки DLL для процесса и ни одного из флагов LOAD_LIBRARY_SEARCH_* *, функция LoadLibraryEx использует путь поиска библиотеки DLL процесса вместо стандартного пути поиска.

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

При вызове LoadLibraryEx с именем сборки без спецификации пути, а сборка указана в манифесте, совместимом с системой, вызов автоматически перенаправляется в параллельной сборке.

Замечания по безопасности

Не используйте функцию SearchPath для получения пути к библиотеке DLL для последующего вызова LoadLibraryEx. Функция searchPath SearchPath использует другой порядок поиска, отличный от LoadLibraryEx, и он не использует режим безопасного поиска процессов, если только это не включено явным образом путем вызова SetSearchPathMode с BASE_SEARCH_PATH_ENABLE_SAFE_SEARCHMODE. Таким образом, SearchPath, скорее всего, сначала выполните поиск текущего рабочего каталога пользователя для указанной библиотеки DLL. Если злоумышленник скопировал вредоносную версию библиотеки DLL в текущий рабочий каталог, путь, полученный SearchPath будет указывать на вредоносную библиотеку DLL, которая LoadLibraryEx будет загружена.

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

Общие сведения о проблемах с безопасностью библиотеки DLL см. в разделе Dynamic-Link Безопасность библиотеки.

Примеры

В следующем примере кода показан вызов LoadLibraryExA.

//Load the FMAPI DLL
hLib = ::LoadLibraryEx(L"fmapi.dll", NULL, NULL);
if ( !hLib )
{
      wprintf(L"Could not load fmapi.dll, Error #%d.\n", GetLastError());
      return;
}

Дополнительные примеры см. в поиск текста для номеров кода ошибки.

Требования

См. также

DllMain

Функции библиотеки Dynamic-Link

порядка поиска библиотеки Dynamic-Link

безопасности библиотеки Dynamic-Link

FindResource

FreeLibrary

GetProcAddress

GetSystemDirectory

GetWindowsDirectory

LoadLibrary

LoadResource

OpenFile

Run-Time динамической компоновки

SearchPath

SetDllDirectory

SetErrorMode