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

Статья
11/20/2024

Функция 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 (Type A). Данные управления и форматирования преобразуются в локальные эквиваленты.
FTP_TRANSFER_TYPE_BINARY	Передает файл с помощью метода передачи образа FTP (type I). Файл передается точно без изменений. Это метод передачи по умолчанию.

[in] lpszCommand

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

[in] dwContext

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

[out] phFtpCommand

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

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

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

Замечания

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

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

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

Заметка

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

Требования

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

См. также

сеансов FTP

функций WinINet

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