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

Статья
03/13/2024

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

Синтаксис

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

Параметры

[in] hConnect

Дескриптор, возвращенный предыдущим вызовом InternetConnect с помощью INTERNET_SERVICE_FTP.

[in] lpszDirectory

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

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

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

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

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

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

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

Примечание

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

Требования

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

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

Сеансы FTP

Функции WinINet

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