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

Статья
03/04/2024

Удаляет указанный каталог на FTP-сервере.

Синтаксис

BOOL FtpRemoveDirectoryA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszDirectory
);

Параметры

[in] hConnect

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

[in] lpszDirectory

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

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

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае. Чтобы получить определенное сообщение об ошибке, вызовите Метод GetLastError. Если сообщение об ошибке указывает, что FTP-сервер отклонил запрос на удаление каталога, используйте InternetGetLastResponseInfo , чтобы определить причину.

Приложение должно использовать FtpGetCurrentDirectory для определения текущего рабочего каталога удаленного сайта, а не предполагать, что удаленная система использует иерархическую схему именования каталогов.

Параметр lpszDirectory может иметь частичные или полные имена файлов относительно текущего каталога.

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

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

Примечание

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

Требования

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

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

Сеансы FTP

Функции WinINet

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