使用 MobiLink 文件传输

UltraLite 支持使用 MobiLink 服务器传输文件的功能。M-Business Anywhere 不需要此功能，因为它有自己的文件部署或传输机制（称为通道同步）。

对于所有其它 API，在以下情况下使用 MobiLink 文件传输机制：

需要将多个文件部署到多个设备（特别是将公司防火墙用作安全措施时）。因为 MobiLink 已配置为通过这些防火墙处理同步，因此使用 MLFileTransfer 机制可以很方便地置备用于升级及其它类型文件传输的设备。
有文件要定向到特定的 MobiLink 用户 ID。这要求在 MobiLink 服务器上为需要的每个用户 ID 都创建一个或多个用户特定目录。如果只有单个版本的文件，则可使用缺省目录。

文件传输工作原理

您可以利用两个由 MobiLink 启动的文件传输机制之一将文件下载到设备：运行 mlfiletransfer 实用程序进行桌面传输，或调用适合于 UltraLite 应用程序编码所使用的 API 的函数。这两种方法都要求：

描述传输目标。

无论是从桌面操作系统使用 mlfiletransfer 实用程序，还是使用适合于 API 的函数，都必须设置目标设备或台式计算机上的文件的本地路径和文件名。如果应用程序中或最终用户未提供任何信息，则假定使用源文件名并将文件存储在当前目录中。

传输目标的目标目录因设备的操作系统而异：
- 在 Windows Mobile 上，如果目标为 NULL，则将文件存储在根目录 ( \ )。
  
  文件名必须遵循 Windows Mobile 的文件名约定。请参见Windows Mobile。
- 在桌面上，如果目标为 NULL，则将文件存储在当前目录。
  
  文件名必须遵循桌面系统的文件名约定。请参见桌面。
- 在 iPhone 上，应当将文件存储在应用程序的文档目录中。可通过使用 NSDocumentDirectory 参数调用 NSSearchPathForDirectories/uDomains 来获取文档目录的位置。
- 在 BlackBerry 上，使用 FileTransfer 对象设置位置。
设置用于标识用户和下载正确文件的 MobiLink 用户证书。

此用户名和口令独立于任何数据库用户 ID 和口令，它们用于向 MobiLink 服务器标识和验证应用程序。
设置要使用的流类型，并定义所需流的参数。这些参数与 UltraLite 支持的 MobiLink 同步参数相同。请参见UltraLite 同步参数和网络协议选项。

大多数同步流都需要用一些参数来标识 MobiLink 服务器地址和控制其它行为。如果设置的流类型值在平台上无效，则流类型将被设置为 TCP/IP，仅支持 HTTP 的 UltraLiteJ 除外。
描述传输机制所需的行为。

例如，可设置允许此机制强制进行下载（即使文件已存在于目标上并未进行更改）的属性，或设置允许继续完成部分下载的属性。也可设置是否想要监视和报告进度。
确保 MobiLink 服务器正在运行，并且是使用 -ftr 选项启动的。
启动传输，并在适用情况下监控下载进度。

通过显示下载进度，用户可取消下载并稍后恢复下载。

另请参见

使用DocCommentXchange 讨论此页。