Функция FtpGetCurrentDirectoryA (wininet.h)
Извлекает текущий каталог для указанного сеанса FTP.
Синтаксис
BOOL FtpGetCurrentDirectoryA(
[in] HINTERNET hConnect,
[out] LPSTR lpszCurrentDirectory,
[in, out] LPDWORD lpdwCurrentDirectory
);
Параметры
[in] hConnect
Обработка сеанса FTP.
[out] lpszCurrentDirectory
Указатель на строку, завершающуюся значением NULL, которая получает абсолютный путь к текущему каталогу.
[in, out] lpdwCurrentDirectory
Указатель на переменную, указывающую длину буфера, в TCHAR. Длина буфера должна содержать место для завершающего символа NULL. Для всех путей достаточно использовать длину MAX_PATH . При возврате функции переменная получает количество символов, скопированных в буфер.
Возвращаемое значение
Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае. Чтобы получить определенное сообщение об ошибке, вызовите Метод GetLastError.
Комментарии
Если буфер lpszCurrentDirectory недостаточно велик, lpdwCurrentDirectory получает количество байтов, необходимое для получения полного текущего имени каталога.
Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из библиотеки DllMain или из конструкторов и деструкторов глобальных объектов.
Примечание
Заголовок wininet.h определяет FtpGetCurrentDirectory в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wininet.h |
| Библиотека | Wininet.lib |
| DLL | Wininet.dll |