Функция GetDllDirectoryA (winbase.h)

Статья
08/27/2023

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

Синтаксис

DWORD GetDllDirectoryA(
  [in]  DWORD nBufferLength,
  [out] LPSTR lpBuffer
);

Параметры

[in] nBufferLength

Размер выходного буфера в символах.

[out] lpBuffer

Указатель на буфер, который получает часть пути поиска для конкретного приложения.

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

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

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

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

Примечание

Заголовок winbase.h определяет GetDllDirectory в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

Порядок поиска библиотеки динамической компоновки (DLL)

SetDllDirectory

Share via