Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Обновления на сайте
Нет.
Перевод
Сегодня вашему вниманию представлен перевод функции GetCurrentDirectory.
GetCurrentDirectory
Функция GetCurrentDirectory извлекает текущую директорию для текущего процесса.
DWORD GetCurrentDirectory(
DWORD nBufferLength, // размер буфера для имени директории
LPTSTR lpBuffer // буфер для имени директории
);
Параметры
nBufferLength – длина буфера для имени текущей директории в TCHAR'ах. Длина буфера
должна включать в себя место для завершающего нулевого символа.
lpBuffer – указатель на буфер, который получает строку с именем текущей директории.
Эта завершающаяся нулем строка определяет абсолютный путь к текущей директории.
Возвращаемые значения
В случае успеха функция возвращает количество символов, записанных в буфер, не
включая завершающий нулевой символ.
В случае неудачи функция возвращает нуль. Для получения дополнительной информации
об ошибке вызовите функцию GetLastError.
Если буфер, на который указывает значение параметра lpBuffer, не имеет достаточного
размера для размещения строки с именем текущей директории, возвращаемое значение
определяет требуемый размер буфера, включая байты, необходимые для завершающего
нулевого символа.
Комментарии
Windows 95/98/Me: GetCurrentDirectoryW поддерживается через Microsoft Layer для
Unicode. Для его использования вы должны добавить некоторые файлы в ваше приложение,
как описано в "Microsoft Layer for Unicode on Windows 95/98/Me Systems".
Требования
Windows NT/2000/XP: включена в Windows NT 3.1 и выше.
Windows 95/98/Me: включена в Windows 95 и выше.
Заголовок: объявлена в Winbase.h; подключать Windows.h.
Библиотека: используйте Kernel32.lib.
Unicode: реализована как версии Unicode и ANSI в Windows NT/2000/XP. Также поддерживается
через Microsoft Layer для Unicode.
См. также
CreateDirectory, GetSystemDirectory, GetWindowsDirectory, RemoveDirectory, SetCurrentDirectory.
хелп по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru