Функция FtpGetCurrentDirectoryA (wininet.h)

Статья
11/20/2024

Извлекает текущий каталог для указанного сеанса FTP.

Синтаксис

BOOL FtpGetCurrentDirectoryA(
  [in]      HINTERNET hConnect,
  [out]     LPSTR     lpszCurrentDirectory,
  [in, out] LPDWORD   lpdwCurrentDirectory
);

Параметры

[in] hConnect

Обработка сеанса FTP.

[out] lpszCurrentDirectory

Указатель на строку, завершающую значение NULL, которая получает абсолютный путь к текущему каталогу.

[in, out] lpdwCurrentDirectory

Указатель на переменную, указывающую длину буфера в TCHARs. Длина буфера должна содержать комнату для завершающего символа NULL. Для всех путей достаточно использовать длину MAX_PATH. Когда функция возвращается, переменная получает количество символов, скопированных в буфер.

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

Возвращает TRUE, если выполнено успешно или FALSE в противном случае. Чтобы получить определенное сообщение об ошибке, вызовите GetLastError.

Замечания

Если буфер lpszCurrentDirectory недостаточно велик, lpdwCurrentDirectory получает количество байтов, необходимых для получения полного текущего имени каталога.

Как и все остальные аспекты API WinINet, эта функция не может быть безопасно вызвана из dllMain или конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для реализации или служб сервера microsoft Windows HTTP Services (WinHTTP).

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h
библиотеки	Wininet.lib
DLL	Wininet.dll

См. также

сеансов FTP

FtpSetCurrentDirectory

функций WinINet

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