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 Services (WinHTTP) 。
 

注意

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

要求

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

另请参阅

FTP 会话

WinINet 函数