通过

FtpCommandA 函数 （wininet.h）

  • 项目

FtpCommand 函数将命令直接发送到 FTP 服务器。

语法

BOOL FtpCommandA(
  [in]  HINTERNET hConnect,
  [in]  BOOL      fExpectResponse,
  [in]  DWORD     dwFlags,
  [in]  LPCSTR    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

指向在打开有效数据套接字时创建的句柄的指针。 fExpectResponse 参数必须设置为 TRUE，才能填充 phFtpCommand。

返回值

如果成功，则返回 TRUE;否则返回 FALSE。 若要获取特定错误消息，请调用 GetLastError。

言论

如果客户端应用程序处于脱机状态，GetLastError 可以返回 ERROR_INTERNET_NO_DIRECT_ACCESS。 如果一个或多个参数无效，GetLastError 将返回 ERROR_INVALID_PARAMETER。

与 WinINet API 的其他所有方面一样，不能从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。

注意 WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP 服务（WinHTTP）。
 

注意

wininet.h 标头将 FtpCommand 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 wininet.h
库 Wininet.lib
DLL Wininet.dll

另请参阅

FTP 会话

WinINet 函数