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

Статья
08/27/2023

Функция FtpCommand отправляет команды непосредственно на FTP-сервер.

Синтаксис

BOOL FtpCommandW(
  [in]  HINTERNET hConnect,
  [in]  BOOL      fExpectResponse,
  [in]  DWORD     dwFlags,
  [in]  LPCWSTR   lpszCommand,
  [in]  DWORD_PTR dwContext,
  [out] HINTERNET *phFtpCommand
);

Параметры

[in] hConnect

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

[in] fExpectResponse

Логическое значение, указывающее, ожидает ли приложение подключения к данным с помощью FTP-сервера. Для этого параметра должно быть задано значение TRUE , если ожидается подключение к данным, или FALSE в противном случае.

[in] dwFlags

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

Значение	Значение
FTP_TRANSFER_TYPE_ASCII	Передает файл с помощью метода передачи FTP ASCII (тип A). Данные элемента управления и форматирования преобразуются в локальные эквиваленты.
FTP_TRANSFER_TYPE_BINARY	Передает файл с помощью метода передачи образа FTP (тип I). Файл передается точно без изменений. Это метод передачи по умолчанию.

[in] lpszCommand

Указатель на строку, содержащую команду для отправки на FTP-сервер.

[in] dwContext

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

[out] phFtpCommand

Указатель на дескриптор, который создается при открытии допустимого сокета данных. Для заполнения phFtpCommandпараметру fExpectResponse должно быть присвоено значение TRUE.

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

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

GetLastError может возвращать ERROR_INTERNET_NO_DIRECT_ACCESS , если клиентское приложение находится в автономном режиме. Если один или несколько параметров недопустимы, GetLastError вернет ERROR_INVALID_PARAMETER.

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

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

Примечание

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

Требования

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

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

Сеансы FTP

Функции WinINet

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