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

Статья
11/20/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 Services (WinHTTP).

Заметка

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

Требования

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

См. также

сеансов FTP

функций WinINet

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