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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] nBufferLength

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

[out] lpBuffer

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

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

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

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista, Windows XP с пакетом обновления 1 (SP1) [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

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

SetDllDirectory

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