Функция SetDllDirectory

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

Синтаксис

BOOL SetDllDirectory(
  LPCTSTR lpPathName
);

Параметры

lpPathName
[in] Указатель на символьную строку с нулем в конце, которая устанавливает добавляемый каталог к пути поиска. Если этот параметр - ПУСТО (NULL), используется заданный по умолчанию путь поиска.

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

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

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

Замечания

Функция SetDllDirectory воздействует на на все последующие вызовы функций LoadLibraryEx и LoadLibrary. После вызова SetDllDirectory, путем поиска DLL является:

  1. Каталог из которого загружается приложение.
  2. Каталог, определенный параметром lpPathName.
  3. Системный каталог. Используйте функцию GetSystemDirectory, чтобы получить путь к этому каталогу. Имя этого каталога - System32.
  4. 16-разрядный системный каталог. Нет никакой функции, которая получает путь к этому каталогу, но он ищется. Имя этого каталога является System.
  5. Каталог Windows. Используйте функцию GetWindowsDirectory, чтобы получить путь к этому каталогу.
  6. Каталоги, которые перечислены в переменной окружения PATH.

Чтобы возвратиться к заданному по умолчанию пути поиска, используемому LoadLibrary и LoadLibraryEx, вызовите SetDllDirectory  с ПУСТО (NULL).

Чтобы компилировать приложение(прикладная программа), которое использует эту функцию, определите макрос _WIN32_WINNT как 0x0502 или позже. Дополнительную информацию, см. в статье Использование заголовочных файлов Windows.

Смотри также

Обзор Динамически подключаемые библиотеки (DLL), Функции, используемые DLLGetDllDirectory, GetLastError, GetSystemDirectory, GetWindowsDirectory, LoadLibrary, LoadLibraryEx

Размещение и совместимость SetDllDirectory

К

Windows XP

Да  SP1

л

Windows 2000

Нет

и

Windows NT

Нет

е

Windows Me

Нет

н

Windows 98

Нет

т

Windows 95

Нет

 
С

Windows Server 2003

Да

е Windows 2000 Server Нет
р Windows NT Server Нет
в    
е    
р    

Используемая библиотека

Kernel32.lib

Используемая DLL kernel32.dll
 Заголовочный файл  

- объявлено в

Winbase.h

 - включено в

Windows.h

 Unicode

Нет

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz