Функция 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 не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).
 

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wininet.h
Библиотека Wininet.lib
DLL Wininet.dll

См. также раздел

Сеансы FTP

FtpSetCurrentDirectory

Функции WinINet