Функция SetDllDirectory

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

Синтаксис

BOOL SetDllDirectory(
  LPCTSTR lpPathName
);

Параметры

lpPathName

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

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

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

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

Замечания

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

Каталог из которого загружается приложение.

Каталог, определенный параметром lpPathName.

Системный каталог. Используйте функцию GetSystemDirectory, чтобы получить путь к этому каталогу. Имя этого каталога - System32.

16-разрядный системный каталог. Нет никакой функции, которая получает путь к этому каталогу, но он ищется. Имя этого каталога является System.

Каталог Windows. Используйте функцию GetWindowsDirectory, чтобы получить путь к этому каталогу.

Каталоги, которые перечислены в переменной окружения PATH.

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

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

Смотри также

Размещение и совместимость 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		Нет
Замечания по платформе		Не имеется