Функция GetDllDirectoryA (winbase.h)
Извлекает относящийся к приложению фрагмент пути поиска, используемый для поиска библиотек 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 |