支持库名称及版本：网络传送支持库 （3.1#0版） 所支持语言：中文(大陆) 本支持库实现对多种协议断点续传下载与FTP上传的支持，并提供了丰富的设置方式。当前版本支持HTTP、FTP、MMS多线程下载及断点续传，以及对RTSP协议的单线程下载及断点续传。用户可以根据各自的主机及网络情况进行设置，本支持库可以运行在linux下，详细情况参见例程。注意：当前版本使用了映射文件模式，并且是一次全部映射的方法，所以最大传送不超过一次映射文件的长度。 本库为一般支持库，需要易系统3.7版本的支持，需要系统核心支持库3.7版本的支持，提供了5种库定义数据类型，提供了66种命令。 操作系统需求： Windows、Linux 支持库文件名： D:\易语言\5.95\lib\downlib.fne ----- 支持库的作者信息 ----- 作者姓名：大连大有吴涛易语言软件开发有限公司 邮政编码：116001 通信地址：辽宁省大连市中山区人民路55号亚太国际金融中心 电话号码：+86(0411)39895831 QQ号码：+86(0411)39895834 电子信箱：service@dywt.com.cn 主页地址：http://www.eyuyan.com 其它信息：祝您一帆风顺，心想事成！ --- 命令类别： 全局命令 --- 调用格式： 〈逻辑型〉 网络通讯设置 （整数型 写入文件大小，整数型 重连时间，整数型 重连次数） - 网络传送支持库->全局命令 英文名称：InitDownLib 初始化下载支持库，进行基本设置.本命令为初级命令。 参数<1>的名称为“写入文件大小”，类型为“整数型（int）”，初始值为“20480”。本参数指定每次写入文件的指定大小，默认为20480, 注意:如果待下载文件的总长度小于此值，那么将不能使用多个线程下载。 参数<2>的名称为“重连时间”，类型为“整数型（int）”，初始值为“0”。出错时连接服务器间隔时间，默认为0。 参数<3>的名称为“重连次数”，类型为“整数型（int）”，初始值为“0”。出错时重复连接服务器次数，默认为0。 操作系统需求： Windows、Linux 调用格式： 〈无返回值〉 设重试时间 （整数型 重试时间） - 网络传送支持库->全局命令 英文名称：SetTautologyTime 设置重新尝试连接的时间。本命令为初级命令。 参数<1>的名称为“重试时间”，类型为“整数型（int）”，初始值为“5000”。尝试重新连接的时间。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 取总下载速度 （） - 网络传送支持库->全局命令 英文名称：GetAllRate 获得所有任务的下载速度。本命令为初级命令。 操作系统需求： Windows、Linux --- 库定义数据类型列表 --- 数据类型名称：下载对象 英文名称：Download 本数据类型为普通类型，共包含 16 个成员命令。 操作系统需求： Windows、Linux 组件事件列表： 调用格式： 〈逻辑型〉 对象．增加新任务 （任务参数 配置信息） - 网络传送支持库->下载对象 英文名称：AddDownFile 增加一个下载文件的任务,当前支持HTTP，FTP，MMS，RTSP协议。成功返回真，失败返回假。注意：默认线程原则上没有限制。但使用时应根据具体情况设置。否则不但起不到提高速度的作用还会影响系统的稳定。本命令为初级对象成员命令。 参数<1>的名称为“配置信息”，类型为“任务参数（TaskParam）”。配置任务相关信息。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．停止指定任务 （字节集变量 任务数据，整数型 执行方式） - 网络传送支持库->下载对象 英文名称：StopDownFile 停止一个下载文件的任务,当前支持HTTP，FTP协议。成功返回真，失败返回假。本命令为初级对象成员命令。 参数<1>的名称为“任务数据”，类型为“字节集（bin）”，提供参数数据时只能提供变量。本参数是用于保存下载任务的相关数据的。 参数<2>的名称为“执行方式”，类型为“整数型（int）”，初始值为“2”。本参数无意义。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．继续下载任务 （任务参数 配置信息，字节集 任务数据） - 网络传送支持库->下载对象 英文名称：ContinueDownFile 继续一个下载文件的任务,当前支持HTTP，FTP，MMS，RTSP协议。成功返回真，失败返回假。注意：继续下载时默认线程数不是根据任务参数中的默认线程数进行设置的，而是根据任务信息中的没有完成的断点信息的数量进行设置的。断点的数量则是根据任务自本次运行以前开启的线程的总数减去已经完成下载任务的线程数获得的。本命令为初级对象成员命令。 参数<1>的名称为“配置信息”，类型为“任务参数（TaskParam）”。配置任务相关信息。 参数<2>的名称为“任务数据”，类型为“字节集（bin）”。本参数是通过“停止任务”命令所获得的任务数据。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．增加线程 （） - 网络传送支持库->下载对象 英文名称：AddDownThread 增加一个下载线程,当前支持HTTP，FTP，MMS协议。如果最大块的长度小于接收大小的2倍时将不能开启新线程注意：下载线程原则上可以无限增加，但是请您根据您的实际情况谨慎使用。不要过多或过与频繁的增加线程，否则不但不能提高效率，相反会影响系统的稳定。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．减少线程 （） - 网络传送支持库->下载对象 英文名称：DecreaseDownThread 减少一个下载线程, 当前支持HTTP，FTP，MMS协议。当只有一个下载线程工作时，将不能结束这个线程。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．限制速度 （整数型 速度） - 网络传送支持库->下载对象 英文名称：SetDownRate 限制下载速度。本命令为初级对象成员命令。 参数<1>的名称为“速度”，类型为“整数型（int）”。限制后的速度，单位为 字节/秒。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．取下载速度 （） - 网络传送支持库->下载对象 英文名称：GetDownRate 获得下载速度，本命令获得的速度为即时速度。如，每间隔1秒调用一次本命令，那么获得的值表示1秒内收到的数据,间隔2秒则表示2秒内收到的数据。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．取已下载长 （） - 网络传送支持库->下载对象 英文名称：GetDownFileSize 获得任务已下载大小。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．取任务数据 （字节集变量 任务数据） - 网络传送支持库->下载对象 英文名称：GetThreadSize 获得任务数据，在指定的时间内执行本命令来取得任务数据。如果下载任务出现异常，可以通过“继续下载任务”来继续任务。本命令为初级对象成员命令。 参数<1>的名称为“任务数据”，类型为“字节集（bin）”，提供参数数据时只能提供变量。本参数是用于保存下载任务的相关数据的。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．取重试次数 （） - 网络传送支持库->下载对象 英文名称：GetTautologyCount 获得重试次数。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．取对象信息 （） - 网络传送支持库->下载对象 英文名称：GetObjInfo 获得下载对象信息,通常用于多个对象使用相同的日志或交互回调函数时，在日志或交互回调函数中确定对象，如果失败返回-1。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．取线程信息 （整数型变量数组 线程信息数组） - 网络传送支持库->下载对象 英文名称：GetThreadInfo 获得线程信息，通常用于多个对象使用相同的日志或交互回调函数时，在日志或交互回调函数中确定线程。本命令为初级对象成员命令。 参数<1>的名称为“线程信息数组”，类型为“整数型（int）”，提供参数数据时只能提供变量数组。本参数是用于保存线程信息数组。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．取任务数据项 （字节集 任务数据，整数型 数据类型，整数型 类型参数） - 网络传送支持库->下载对象 英文名称：GetStopDownObjInfo 获得通过“停止指定任务”命令返回的任务信息中的各类数据。失败返回-1。本命令为初级对象成员命令。 参数<1>的名称为“任务数据”，类型为“字节集（bin）”。本参数是通过“停止任务”命令所获得的任务数据。 参数<2>的名称为“数据类型”，类型为“整数型（int）”。需要获得的任务信息的类型。如果”类型参数“作为指定具体断点序号使用，那么它从1开始不大于断点个数,1 待下载文件总长度，2 已下载总长度,3 断点个数,4 指定断点开始下载位置,类型参数为序号,5 指定断点待下载长度,类型参数为序号,6 指定断点已下载长度,类型参数为序号。 参数<3>的名称为“类型参数”，类型为“整数型（int）”，初始值为“0”。根据”数据类型“参数的不同而不同。当需要查询的信息类型没有指定本参数的意义时，本参数无意义。 操作系统需求： Windows、Linux 调用格式： 〈文本型〉 对象．取本地文件路径 （） - 网络传送支持库->下载对象 英文名称：GetFilePath 获得待下载文件保存在本地的路径。本命令在收到”存在同名文件“消息时使用可以获得已经存在的同名文件的路径。本命令在收到“下载上传开始”消息后使用可以获得当前下载的文件保存在本地的准确路径。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．设新文件名 （文本型 新文件名） - 网络传送支持库->下载对象 英文名称：SetNewName 本命令用来设置新的本地文件名。本命令必须是在处理“存在同名文件”这个消息的过程中使用。并且返回 #设置新名。本命令为初级对象成员命令。 参数<1>的名称为“新文件名”，类型为“文本型（text）”。新的本地文件名。 操作系统需求： Windows、Linux --------------------------------------------------- 数据类型名称：FTP上传对象 英文名称：FtpUpload 本数据类型为普通类型，共包含 8 个成员命令。 操作系统需求： Windows、Linux 组件事件列表： 调用格式： 〈逻辑型〉 对象．上传文件 （任务参数 配置信息） - 网络传送支持库->FTP上传对象 英文名称：UpDataFile 增加一个上传文件的任务,当前支持FTP协议。成功返回真，失败返回假。本命令为初级对象成员命令。 参数<1>的名称为“配置信息”，类型为“任务参数（TaskParam）”。配置任务相关信息。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．停止上传 （） - 网络传送支持库->FTP上传对象 英文名称：StopUpData 停止一个上传文件的任务,当前支持FTP协议。成功返回真，失败返回假。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．限制速度 （整数型 速度） - 网络传送支持库->FTP上传对象 英文名称：SetRate 限制上传速度。本命令为初级对象成员命令。 参数<1>的名称为“速度”，类型为“整数型（int）”。指定上传速度。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．取上传速度 （） - 网络传送支持库->FTP上传对象 英文名称：GetRate 获得上传速度,本命令获得的速度为即时速度。如，每间隔1秒调用一次本命令，那么获得的值表示1秒内收到的数据间隔2秒则表示2秒内收到的数据。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．取已上传长 （） - 网络传送支持库->FTP上传对象 英文名称：GetUpDataSize 获得任务已上传大小。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．取重试数 （） - 网络传送支持库->FTP上传对象 英文名称：GetUpDataTautologyCount 获得重试次数。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．设新文件名 （文本型 新文件名） - 网络传送支持库->FTP上传对象 英文名称：SetNewName 本命令用来设置新的上传文件名。本命令为初级对象成员命令。 参数<1>的名称为“新文件名”，类型为“文本型（text）”，初始值为“newfile”。上传到服务器的文件的新名。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．取对象信息 （） - 网络传送支持库->FTP上传对象 英文名称：GetFtpObjInfo 获得FTP上传对象信息,通常用于多个FTP上传对象使用相同的日志或交互回调函数时，在日志或交互回调函数中确定FTP上传对象, 如果失败返回-1。本命令为初级对象成员命令。 操作系统需求： Windows、Linux --------------------------------------------------- 数据类型名称：FTP辅助对象 英文名称：FtpAssistant 本数据类型为普通类型，共包含 12 个成员命令。 操作系统需求： Windows、Linux 组件事件列表： 调用格式： 〈逻辑型〉 对象．连接FTP服务器 （文本型 FTP服务器地址，文本型 用户名，文本型 密码，整数型 端口，［子程序指针 日志回调函数］，［整数型 超时］） - 网络传送支持库->FTP辅助对象 英文名称：FtpLogin 连接到互联网上指定地址处的FTP服务器。成功返回真，失败返回假。本命令为初级对象成员命令。 参数<1>的名称为“FTP服务器地址”，类型为“文本型（text）”，初始值为“ftp://127.0.0.1/”。本参数指定FTP服务器在互联网上的地址，格式为 ftp://域名或ip/。 参数<2>的名称为“用户名”，类型为“文本型（text）”，初始值为“anonymous”。本参数提供用作通过FTP服务器用户验证的用户名称，如果被省略，默认值为匿名用户名“anonymous”。 参数<3>的名称为“密码”，类型为“文本型（text）”，初始值为“”。本参数提供用作通过FTP服务器用户验证的密码，如果被省略，默认值为空文本。 参数<4>的名称为“端口”，类型为“整数型（int）”，初始值为“21”。本参数提供欲连接到FTP服务器上的端口号，如果被省略，默认值为标准端口 21。 参数<5>的名称为“日志回调函数”，类型为“子程序指针（SubPtr）”，可以被省略。注册一个回调函数，系统产生日志时会调用此函数通知用户,如果为0则不能接收日志，默认为0。回调函数需要有5个参数，第一个参数（整数型），线程信息，第二个参数（文本型），消息产生的时间。第三个参数（文本型），消息的正文。第四个参数（整数型），消息类型，参见”传送常量“第五个参数（整数型），对象信息，可以通过“取对象信息”获得下载或上传对象的信息与本参数比较，从而确定本消息属于哪个对象。 参数<6>的名称为“超时”，类型为“整数型（int）”，可以被省略。登录过程中数据交互的超时时间,单位为毫秒，如果忽略则默认为2000。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．断开FTP服务器 （） - 网络传送支持库->FTP辅助对象 英文名称：FtpQuit 断开通过“连接FTP服务器”命令建立的到互联网上FTP服务器的连接。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．删除文件 （文本型 欲删除的FTP文件） - 网络传送支持库->FTP辅助对象 英文名称：FtpDelFile 删除FTP服务器上的指定文件。成功返回真，失败返回假。本命令为初级对象成员命令。 参数<1>的名称为“欲删除的FTP文件”，类型为“文本型（text）”。本参数指定在FTP服务器上欲删除文件的路径。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．文件改名 （文本型 欲改名的FTP文件，文本型 新文件名称） - 网络传送支持库->FTP辅助对象 英文名称：FtpReFileName 更改FTP服务器上指定文件的名称。成功返回真，失败返回假。本命令为初级对象成员命令。 参数<1>的名称为“欲改名的FTP文件”，类型为“文本型（text）”。本参数指定FTP服务器上欲改名文件的路径。 参数<2>的名称为“新文件名称”，类型为“文本型（text）”。本参数指定欲改为的文件名称。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．创建目录 （文本型 FTP目录路径） - 网络传送支持库->FTP辅助对象 英文名称：FtpCreateDir 在FTP服务器上指定位置处创建新的目录。成功返回真，失败返回假。本命令为初级对象成员命令。 参数<1>的名称为“FTP目录路径”，类型为“文本型（text）”。FTP目录路径。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．删除目录 （文本型 FTP目录路径） - 网络传送支持库->FTP辅助对象 英文名称：FtpDelDir 删除FTP服务器上的指定目录。成功返回真，失败返回假。本命令为初级对象成员命令。 参数<1>的名称为“FTP目录路径”，类型为“文本型（text）”。FTP目录路径。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．置现行目录 （文本型 FTP目录路径） - 网络传送支持库->FTP辅助对象 英文名称：FtpSetCurrentDir 设置FTP服务器上的当前目录，设置后可以在其他FTP命令中使用相对路径来指定文件。成功返回真，失败返回假。本命令为初级对象成员命令。 参数<1>的名称为“FTP目录路径”，类型为“文本型（text）”。FTP目录路径。 操作系统需求： Windows、Linux 调用格式： 〈文本型〉 对象．取现行目录 （） - 网络传送支持库->FTP辅助对象 英文名称：FtpGetCurrentDir 返回FTP服务器上的当前目录。成功返回目录路径，失败返回空文本。本命令为初级对象成员命令。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．取目录列表 （［文本型 欲列出的文件］，［文本型变量/变量数组 存放文件名的数组变量］，［整数型变量/变量数组 存放文件属性的数组变量］，［长整数型变量/变量数组 存放文件尺寸的数组变量］，［日期时间型变量/变量数组 存放文件时间的数组变量］） - 网络传送支持库->FTP辅助对象 英文名称：FtpGetDirList 返回FTP服务器上指定目录内的所有匹配文件和子目录信息。成功返回被找到的文件和子目录的数目，失败返回 -1失败的原因有可能是FTP服务器的目录结构暂时不被支持。本命令为初级对象成员命令。 参数<1>的名称为“欲列出的文件”，类型为“文本型（text）”，可以被省略。可以包含路径，可以使用多字符 (*) 和单字符 (?) 通配符来指定多重文件及目录。 参数<2>的名称为“存放文件名的数组变量”，类型为“文本型（text）”，可以被省略，提供参数数据时只能提供变量及变量数组。提供参数数据时只能提供变量数组。在命令执行完毕后，本变量数组内被顺序填入所找到的匹配文件和子目录名称。变量数组内原有数据被全部销毁，变量数组的维数被自动调整为所找到的文件数目。 参数<3>的名称为“存放文件属性的数组变量”，类型为“整数型（int）”，可以被省略，提供参数数据时只能提供变量及变量数组。当前不被支持,留做以后扩展。 参数<4>的名称为“存放文件尺寸的数组变量”，类型为“长整数型（int64）”，可以被省略，提供参数数据时只能提供变量及变量数组。提供参数数据时只能提供变量数组。在命令执行完毕后，本变量数组内被顺序填入所找到的匹配文件的尺寸，并与文件名数组成员一一对应。 参数<5>的名称为“存放文件时间的数组变量”，类型为“日期时间型（date）”，可以被省略，提供参数数据时只能提供变量及变量数组。提供参数数据时只能提供变量数组。在命令执行完毕后，本变量数组内被顺序填入所找到的匹配文件的最后修改时间，并与文件名数组成员一一对应。变量数组内原有数据被全部销毁，变量数组的维数被自动调整为所找到的文件数目。 操作系统需求： Windows、Linux 调用格式： 〈逻辑型〉 对象．移动文件 （文本型 旧文件路径，文本型 新文件路径） - 网络传送支持库->FTP辅助对象 英文名称：FtpMoveFile 移动文件或目录到新的位置。本命令为初级对象成员命令。 参数<1>的名称为“旧文件路径”，类型为“文本型（text）”。旧文件路径。 参数<2>的名称为“新文件路径”，类型为“文本型（text）”。新文件路径。 操作系统需求： Windows、Linux 调用格式： 〈整数型〉 对象．执行FTP命令 （文本型 FTP命令，［文本型变量 返回命令数据］） - 网络传送支持库->FTP辅助对象 英文名称：FtpRunCmd 执行一条FTP命令, 返回服务器返回的信息代码。如果执行失败返回0。 本命令只有通过“连接FTP服务器”命令连接到FTP服务器以后才能使用。本命令为高级对象成员命令。 参数<1>的名称为“FTP命令”，类型为“文本型（text）”。欲执行的FTP命令。 参数<2>的名称为“返回命令数据”，类型为“文本型（text）”，可以被省略，提供参数数据时只能提供变量。执行FTP命令后服务器返回的命令文本，最大支持返回51200字节。 操作系统需求： Windows、Linux --------------------------------------------------- 数据类型名称：任务参数 英文名称：TaskParam 本数据类型为普通类型，共包含 20 个成员变量。 操作系统需求： Windows、Linux 成员<1>的中文名称为“类型”，英文名称为“Type”，类型为“整数型（int）”，初始值为“1”。 指定任务类型 可以为以下常量 #下载 #上传 #覆盖 #续传 #改名 #跳过 #被动选择。 成员<2>的中文名称为“文件地址”，英文名称为“Url”，类型为“文本型（text）”，初始值为“”。 本参数指定欲读取文件在互联网上的地址，即（URL）。 成员<3>的中文名称为“本地文件路径”，英文名称为“LocalFilePath”，类型为“文本型（text）”，初始值为“”。 本参数指定被下载或待上传文件的本地保存位置，当作为下载文件保存路径使用时。如果没有给定文件名，那必须是一个以“\”结尾的文件路径。系统会根据“文件地址”指定的的文件名作为本地保存的文件名，系统会处理重定向情况。当收到“下载上传开始”消息后可以通过“取本地文件路径”获得包含文件名的文件路径。 成员<4>的中文名称为“用户名”，英文名称为“UserName”，类型为“文本型（text）”，初始值为“anonymous”。 需要身份验证时使用的用户名,当前只用做FTP登录时使用。 成员<5>的中文名称为“用户密码”，英文名称为“PassWord”，类型为“文本型（text）”，初始值为“anonymous@123.com”。 需要身份验证时使用的密码,当前只用做FTP登录时使用。 成员<6>的中文名称为“默认线程数”，英文名称为“InitThreadCount”，类型为“整数型（int）”，初始值为“1”。 任务启动时默认开启的线程数,默认为1。 成员<7>的中文名称为“下载速度”，英文名称为“Rate”，类型为“整数型（int）”，初始值为“0”。 本参数用来限制一个任务的下载速度，如果为0则不做限制。默认为0。 成员<8>的中文名称为“连接超时”，英文名称为“ConnectionTimeOut”，类型为“整数型（int）”，初始值为“20000”。 连接服务器的超时时间，如果过了这个时间服务器还没有回应则返回，如果用户设置了重试次数，那么会进行指定次数的重试。本参数为毫秒，默认为20000。 成员<9>的中文名称为“发送超时”，英文名称为“SendDataTimeOut”，类型为“整数型（int）”，初始值为“20000”。 发送数据的超时时间，如果用户设置了重试次数，那么会进行指定次数的重试。单位为毫秒，默认为20000。 成员<10>的中文名称为“接收超时”，英文名称为“RecvDataTimeOut”，类型为“整数型（int）”，初始值为“20000”。 接收数据的超时时间，如果用户设置了重试次数，那么会进行指定次数的重试。单位为毫秒，默认为20000。 成员<11>的中文名称为“线程等待超时”，英文名称为“ThreadTimeOut”，类型为“整数型（int）”，初始值为“1000”。 结束线程时等待的时间，单位为毫秒，默认为1000。 成员<12>的中文名称为“接收大小”，英文名称为“RecvBlockSize”，类型为“整数型（int）”，初始值为“20480”。 每次接收数据的块大小，通过调节大小可以加快下载速度，但过大会导致意外错误，请根据实际情况调节。本值不能大于初始化库命令中设置的写入文件长度。单位为字节。默认为20480字节。 成员<13>的中文名称为“发送大小”，英文名称为“SendBlockSize”，类型为“整数型（int）”，初始值为“1024”。 每次发送数据的块大小，通过调节大小可以加快上传速度，但过大会导致意外错误，请根据实际情况调节。单位为字节。默认为1024字节。 成员<14>的中文名称为“日志回调函数”，英文名称为“LogCallBack”，类型为“子程序指针（SubPtr）”。 注册一个回调函数，系统产生日志时会调用此函数通知用户。如果为0则不能接收日志，默认为0。回调函数需要有5个参数：第一个参数，线程信息（整数型），可以通过“取线程信息”获得每个上传或下载对象的线程信息，与本参数比较从而确定发送本消息的对象；第二个参数，消息产生的时间（文本型）；第三个参数，消息的正文（文本型）；第四个参数，消息类型（整数型），参见“#传送常量.*”；第五个参数，对象信息（整数型），可以通过“取对象信息()”获得下载或上传对象的信息与本参数比较，从而确定本消息属于哪个对象。 成员<15>的中文名称为“交互回调函数”，英文名称为“MutualCallBack”，类型为“子程序指针（SubPtr）”。 注册一个回调函数，系统产生需要交互的消息时调用此函数，具体消息请参见传送常量中设置的消息常量。如果为0则不接收，默认为0。回调函数需要有5个参数，一个整数型的返回值。返回值根据消息类型的不同而不同，如果没有说明，则返回值没有意义。参见具体的消息。第一个参数，消息类型（整数型），参见“#传送常量.*”；第二个参数，线程信息（整数型），可以通过”取线程信息“获得每个上传或下载对象的线程信息，与本参数比较从而确定发送本消息的对象，此参数值可能为0，表示不与特定线程有关；第三个参数（整数型）根据消息类型的不同而不同，参见具体的消息；第四个参数（整数型）根据消息类型的不同而不同，参见具体的消息；第五个参数，对象信息（整数型），可以通过“取对象信息()”获得下载或上传对象的信息与本参数比较，从而确定本消息属于哪个对象。 成员<16>的中文名称为“备用文件名”，英文名称为“ReFileName”，类型为“文本型（text）”，初始值为“”。 当类型为“改名“时，本参数为上传时使用的新文件名，默认为空。 成员<17>的中文名称为“传送类型”，英文名称为“CarryType”，类型为“整数型（int）”，初始值为“1”。 FTP上传或下载时用来区分传送类型。1 为二进制，2 为文本 3 为根据“类型区分串”选择。 成员<18>的中文名称为“类型区分串”，英文名称为“CarryTypeStr”，类型为“文本型（text）”，初始值为“.exe|.rar|.zip|.gif|.jpg|.mp3|.rm”。 FTP上传或下载时用来区分传送类型的字符串。本字符串由多个通过“|”分割的扩展名组成，如果待下载或上传文件的扩展名被包含在本字符串那么上传的类型为二进制模式否则为ASCII码模式,最大长度为512个字节例如：“.exe|.rar|.zip”.遇到带有上述扩展名的文件则起用二进制模式传送注意：本参数只在“传送类型”为3时有效。 成员<19>的中文名称为“代理服务器”，英文名称为“ProxyServer”，类型为“文本型（text）”。 目前只支持HTTP GET方式的代理服务器, 格式为 IP地址:端口号 如: 192.168.0.1:80。 成员<20>的中文名称为“引用”，英文名称为“Referer”，类型为“文本型（text）”。 用户可以根据实际情况填写，如果不填系统会自动填充。 组件事件列表： 成员“类型”所在数据类型为“任务参数”，英文名称为“Type”，类型为“整数型（int）”，初始值为“1”。 指定任务类型 可以为以下常量 #下载 #上传 #覆盖 #续传 #改名 #跳过 #被动选择。 成员“文件地址”所在数据类型为“任务参数”，英文名称为“Url”，类型为“文本型（text）”，初始值为“”。 本参数指定欲读取文件在互联网上的地址，即（URL）。 成员“本地文件路径”所在数据类型为“任务参数”，英文名称为“LocalFilePath”，类型为“文本型（text）”，初始值为“”。 本参数指定被下载或待上传文件的本地保存位置，当作为下载文件保存路径使用时。如果没有给定文件名，那必须是一个以“\”结尾的文件路径。系统会根据“文件地址”指定的的文件名作为本地保存的文件名，系统会处理重定向情况。当收到“下载上传开始”消息后可以通过“取本地文件路径”获得包含文件名的文件路径。 成员“用户名”所在数据类型为“任务参数”，英文名称为“UserName”，类型为“文本型（text）”，初始值为“anonymous”。 需要身份验证时使用的用户名,当前只用做FTP登录时使用。 成员“用户密码”所在数据类型为“任务参数”，英文名称为“PassWord”，类型为“文本型（text）”，初始值为“anonymous@123.com”。 需要身份验证时使用的密码,当前只用做FTP登录时使用。 成员“默认线程数”所在数据类型为“任务参数”，英文名称为“InitThreadCount”，类型为“整数型（int）”，初始值为“1”。 任务启动时默认开启的线程数,默认为1。 成员“下载速度”所在数据类型为“任务参数”，英文名称为“Rate”，类型为“整数型（int）”，初始值为“0”。 本参数用来限制一个任务的下载速度，如果为0则不做限制。默认为0。 成员“连接超时”所在数据类型为“任务参数”，英文名称为“ConnectionTimeOut”，类型为“整数型（int）”，初始值为“20000”。 连接服务器的超时时间，如果过了这个时间服务器还没有回应则返回，如果用户设置了重试次数，那么会进行指定次数的重试。本参数为毫秒，默认为20000。 成员“发送超时”所在数据类型为“任务参数”，英文名称为“SendDataTimeOut”，类型为“整数型（int）”，初始值为“20000”。 发送数据的超时时间，如果用户设置了重试次数，那么会进行指定次数的重试。单位为毫秒，默认为20000。 成员“接收超时”所在数据类型为“任务参数”，英文名称为“RecvDataTimeOut”，类型为“整数型（int）”，初始值为“20000”。 接收数据的超时时间，如果用户设置了重试次数，那么会进行指定次数的重试。单位为毫秒，默认为20000。 成员“线程等待超时”所在数据类型为“任务参数”，英文名称为“ThreadTimeOut”，类型为“整数型（int）”，初始值为“1000”。 结束线程时等待的时间，单位为毫秒，默认为1000。 成员“接收大小”所在数据类型为“任务参数”，英文名称为“RecvBlockSize”，类型为“整数型（int）”，初始值为“20480”。 每次接收数据的块大小，通过调节大小可以加快下载速度，但过大会导致意外错误，请根据实际情况调节。本值不能大于初始化库命令中设置的写入文件长度。单位为字节。默认为20480字节。 成员“发送大小”所在数据类型为“任务参数”，英文名称为“SendBlockSize”，类型为“整数型（int）”，初始值为“1024”。 每次发送数据的块大小，通过调节大小可以加快上传速度，但过大会导致意外错误，请根据实际情况调节。单位为字节。默认为1024字节。 成员“日志回调函数”所在数据类型为“任务参数”，英文名称为“LogCallBack”，类型为“子程序指针（SubPtr）”。 注册一个回调函数，系统产生日志时会调用此函数通知用户。如果为0则不能接收日志，默认为0。回调函数需要有5个参数：第一个参数，线程信息（整数型），可以通过“取线程信息”获得每个上传或下载对象的线程信息，与本参数比较从而确定发送本消息的对象；第二个参数，消息产生的时间（文本型）；第三个参数，消息的正文（文本型）；第四个参数，消息类型（整数型），参见“#传送常量.*”；第五个参数，对象信息（整数型），可以通过“取对象信息()”获得下载或上传对象的信息与本参数比较，从而确定本消息属于哪个对象。 成员“交互回调函数”所在数据类型为“任务参数”，英文名称为“MutualCallBack”，类型为“子程序指针（SubPtr）”。 注册一个回调函数，系统产生需要交互的消息时调用此函数，具体消息请参见传送常量中设置的消息常量。如果为0则不接收，默认为0。回调函数需要有5个参数，一个整数型的返回值。返回值根据消息类型的不同而不同，如果没有说明，则返回值没有意义。参见具体的消息。第一个参数，消息类型（整数型），参见“#传送常量.*”；第二个参数，线程信息（整数型），可以通过”取线程信息“获得每个上传或下载对象的线程信息，与本参数比较从而确定发送本消息的对象，此参数值可能为0，表示不与特定线程有关；第三个参数（整数型）根据消息类型的不同而不同，参见具体的消息；第四个参数（整数型）根据消息类型的不同而不同，参见具体的消息；第五个参数，对象信息（整数型），可以通过“取对象信息()”获得下载或上传对象的信息与本参数比较，从而确定本消息属于哪个对象。 成员“备用文件名”所在数据类型为“任务参数”，英文名称为“ReFileName”，类型为“文本型（text）”，初始值为“”。 当类型为“改名“时，本参数为上传时使用的新文件名，默认为空。 成员“传送类型”所在数据类型为“任务参数”，英文名称为“CarryType”，类型为“整数型（int）”，初始值为“1”。 FTP上传或下载时用来区分传送类型。1 为二进制，2 为文本 3 为根据“类型区分串”选择。 成员“类型区分串”所在数据类型为“任务参数”，英文名称为“CarryTypeStr”，类型为“文本型（text）”，初始值为“.exe|.rar|.zip|.gif|.jpg|.mp3|.rm”。 FTP上传或下载时用来区分传送类型的字符串。本字符串由多个通过“|”分割的扩展名组成，如果待下载或上传文件的扩展名被包含在本字符串那么上传的类型为二进制模式否则为ASCII码模式,最大长度为512个字节例如：“.exe|.rar|.zip”.遇到带有上述扩展名的文件则起用二进制模式传送注意：本参数只在“传送类型”为3时有效。 成员“代理服务器”所在数据类型为“任务参数”，英文名称为“ProxyServer”，类型为“文本型（text）”。 目前只支持HTTP GET方式的代理服务器, 格式为 IP地址:端口号 如: 192.168.0.1:80。 成员“引用”所在数据类型为“任务参数”，英文名称为“Referer”，类型为“文本型（text）”。 用户可以根据实际情况填写，如果不填系统会自动填充。 --------------------------------------------------- 数据类型名称：传送常量 英文名称：DownConst 本数据类型为枚举常量集合类型，共包含 25 个枚举常量值。 操作系统需求： Windows、Linux 本数据类型包括了下载及FTP上传对象用到的常量。 枚举常量值<1>的中文名称为“下载”，值为4096。 下载文件与上传互斥。 枚举常量值<2>的中文名称为“上传”，值为8192。 上传文件与下载互斥。 枚举常量值<3>的中文名称为“覆盖”，值为1。 覆盖已存在的同名文件。如果选择本模式上传过程中如果遇到同名文件不向用户询问，直接按此模式所指示的方式处理，与，被动选择，续传，改名，跳过互斥。 枚举常量值<4>的中文名称为“续传”，值为2。 如果已存在的同名文件小于待上传文件则根据断点位置继续上传。如果选择本模式上传过程中如果遇到同名文件不向用户询问，直接按此模式所指示的方式处理，与被动选择，覆盖，改名，跳过互斥。 枚举常量值<5>的中文名称为“改名”，值为4。 发现已存在的同名文件时使用FTP备用文件名保存，如果选择本模式上传过程中如果遇到同名文件不向用户询问，直接按此模式所指示的方式处理，与被动选择，续传，覆盖，跳过互斥。 枚举常量值<6>的中文名称为“跳过”，值为8。 发现已存在的同名文件则跳过，不做任何操作.如果选择本模式上传过程中如果遇到同名文件不向用户询问，直接按此模式所指示的方式处理，与被动选择，续传，改名，覆盖互斥。 枚举常量值<7>的中文名称为“被动选择”，值为16。 当发现已存在的同名文件时系统将调用“交互回调函数”并发送“发现已存在文件消息”通知用户，用户可根据实际情况返回#跳过，#改名，#覆盖，#续传，与跳过，续传，改名，覆盖互斥。 枚举常量值<9>的中文名称为“发现存在文件”，值为2。 只有FTP上传对象有效，当发现已存在的同名文件时系统发送本消息通知用户。回调函数的参数3为已存在文件的大小，回调函数的参数4未使用。注意:只有设置为“被动选择”时才会收到本消息。本消息有返回值,可以为以下常量 #跳过，#改名，#覆盖，#续传。 枚举常量值<10>的中文名称为“下载上传开始”，值为3。 开始下载或上传时发送本消息通知用户。回调函数的参数3为待下载或待上传的文件大小，回调函数的参数4未使用。 枚举常量值<11>的中文名称为“下载上传结束”，值为4。 下载、上传完毕，或用户结束下载、上传，系统发送本消息。回调函数的参数3为任务传送的总长度，回调函数的参数4未使用。 枚举常量值<12>的中文名称为“新下载线程启动”，值为5。 执行“增加线程”系统进行相关处理后发送本消息通知用户。 枚举常量值<13>的中文名称为“下载线程继续下载”，值为7。 回调函数的参数3为本线程开始下载位置，回调函数的参数4为本线程结束下载位置。当下载线程完成指定下载任务后会查找是否有其它任务需要下载。比如，被中断的线程没有下载完毕的任务。如果发现存在这样的任务则发送本消息通知用户。 枚举常量值<14>的中文名称为“线程正常结束”，值为8。 回调函数的参数3为结束位置，回调函数的参数4未使用。线程正常结束后系统进行结束处理后发送本消息通知用户。 枚举常量值<15>的中文名称为“线程异常结束”，值为9。 回调函数的参数3为结束位置，回调函数的参数4未使用。线程异常结束后系统进行结束处理后发送本消息通知用户。 枚举常量值<16>的中文名称为“收到数据”，值为16。 回调函数的参数3为接收到数据的大小，此值正常情况下等于接收大小；回调函数的参数4未使用。线程接收到指定大小的数据后发送本消息通知用户。 枚举常量值<17>的中文名称为“发送数据”，值为17。 回调函数的参数3为发送数据的大小，此值正常情况下等于发送大小；回调函数的参数4未使用。线程发送指定大小的数据后发送本消息通知用户。 枚举常量值<18>的中文名称为“系统日志”，值为0。 系统所产生日志。 枚举常量值<19>的中文名称为“错误日志”，值为3。 错误时所产生的日志。 枚举常量值<20>的中文名称为“接收日志”，值为2。 从服务器接收到数据时发送本类型的日志消息通知用户。 枚举常量值<21>的中文名称为“发送日志”，值为1。 向服务器发送数据时发送本类型的日志消息通知用户。 枚举常量值<22>的中文名称为“下载数据范围”，值为6。 回调函数的参数3为本线程开始下载位置，回调函数的参数4为本线程结束下载位置。收到“新下载线程启动”消息后会收到本消息，本消息说明了新下载线程的下载范围。注意：本消息是在与服务器交互完毕后，准备下载数据前产生的，本消息可以用来确定正式开始接收数据。 枚举常量值<23>的中文名称为“系统处理”，值为0。 系统自动改名，如已经存在同名文件“file.exe”，将自动更名为“file(1).exe”，如果发现“file(1).exe”也存在则括号中的数字加1，即“file(2).exe”，直到“file(99).exe”为止。 枚举常量值<24>的中文名称为“结束下载”，值为1。 当收到“存在同名文件”时使用。用来结束下载线程。 枚举常量值<25>的中文名称为“设置新名”，值为2。 当收到“存在同名文件”时使用。如果返回本值，那么需要在回调函数返回前调用下载对象中的“设新文件名”。 枚举常量值<26>的中文名称为“存在同名文件”，值为18。 当下载对象创建本地文件时，发现已存在的同名文件时系统发送本消息通知用户。回调函数的参数3为已存在文件的大小，回调函数的参数4为待下载文件的大小。本消息有返回值，可以为以下常量 #系统处理，#结束下载，#设置新名。 组件事件列表： 枚举常量值“下载”所处集合数据类型为“传送常量”，值为4096。 下载文件与上传互斥。 枚举常量值“上传”所处集合数据类型为“传送常量”，值为8192。 上传文件与下载互斥。 枚举常量值“覆盖”所处集合数据类型为“传送常量”，值为1。 覆盖已存在的同名文件。如果选择本模式上传过程中如果遇到同名文件不向用户询问，直接按此模式所指示的方式处理，与，被动选择，续传，改名，跳过互斥。 枚举常量值“续传”所处集合数据类型为“传送常量”，值为2。 如果已存在的同名文件小于待上传文件则根据断点位置继续上传。如果选择本模式上传过程中如果遇到同名文件不向用户询问，直接按此模式所指示的方式处理，与被动选择，覆盖，改名，跳过互斥。 枚举常量值“改名”所处集合数据类型为“传送常量”，值为4。 发现已存在的同名文件时使用FTP备用文件名保存，如果选择本模式上传过程中如果遇到同名文件不向用户询问，直接按此模式所指示的方式处理，与被动选择，续传，覆盖，跳过互斥。 枚举常量值“跳过”所处集合数据类型为“传送常量”，值为8。 发现已存在的同名文件则跳过，不做任何操作.如果选择本模式上传过程中如果遇到同名文件不向用户询问，直接按此模式所指示的方式处理，与被动选择，续传，改名，覆盖互斥。 枚举常量值“被动选择”所处集合数据类型为“传送常量”，值为16。 当发现已存在的同名文件时系统将调用“交互回调函数”并发送“发现已存在文件消息”通知用户，用户可根据实际情况返回#跳过，#改名，#覆盖，#续传，与跳过，续传，改名，覆盖互斥。 枚举常量值“发现存在文件”所处集合数据类型为“传送常量”，值为2。 只有FTP上传对象有效，当发现已存在的同名文件时系统发送本消息通知用户。回调函数的参数3为已存在文件的大小，回调函数的参数4未使用。注意:只有设置为“被动选择”时才会收到本消息。本消息有返回值,可以为以下常量 #跳过，#改名，#覆盖，#续传。 枚举常量值“下载上传开始”所处集合数据类型为“传送常量”，值为3。 开始下载或上传时发送本消息通知用户。回调函数的参数3为待下载或待上传的文件大小，回调函数的参数4未使用。 枚举常量值“下载上传结束”所处集合数据类型为“传送常量”，值为4。 下载、上传完毕，或用户结束下载、上传，系统发送本消息。回调函数的参数3为任务传送的总长度，回调函数的参数4未使用。 枚举常量值“新下载线程启动”所处集合数据类型为“传送常量”，值为5。 执行“增加线程”系统进行相关处理后发送本消息通知用户。 枚举常量值“下载线程继续下载”所处集合数据类型为“传送常量”，值为7。 回调函数的参数3为本线程开始下载位置，回调函数的参数4为本线程结束下载位置。当下载线程完成指定下载任务后会查找是否有其它任务需要下载。比如，被中断的线程没有下载完毕的任务。如果发现存在这样的任务则发送本消息通知用户。 枚举常量值“线程正常结束”所处集合数据类型为“传送常量”，值为8。 回调函数的参数3为结束位置，回调函数的参数4未使用。线程正常结束后系统进行结束处理后发送本消息通知用户。 枚举常量值“线程异常结束”所处集合数据类型为“传送常量”，值为9。 回调函数的参数3为结束位置，回调函数的参数4未使用。线程异常结束后系统进行结束处理后发送本消息通知用户。 枚举常量值“收到数据”所处集合数据类型为“传送常量”，值为16。 回调函数的参数3为接收到数据的大小，此值正常情况下等于接收大小；回调函数的参数4未使用。线程接收到指定大小的数据后发送本消息通知用户。 枚举常量值“发送数据”所处集合数据类型为“传送常量”，值为17。 回调函数的参数3为发送数据的大小，此值正常情况下等于发送大小；回调函数的参数4未使用。线程发送指定大小的数据后发送本消息通知用户。 枚举常量值“系统日志”所处集合数据类型为“传送常量”，值为0。 系统所产生日志。 枚举常量值“错误日志”所处集合数据类型为“传送常量”，值为3。 错误时所产生的日志。 枚举常量值“接收日志”所处集合数据类型为“传送常量”，值为2。 从服务器接收到数据时发送本类型的日志消息通知用户。 枚举常量值“发送日志”所处集合数据类型为“传送常量”，值为1。 向服务器发送数据时发送本类型的日志消息通知用户。 枚举常量值“下载数据范围”所处集合数据类型为“传送常量”，值为6。 回调函数的参数3为本线程开始下载位置，回调函数的参数4为本线程结束下载位置。收到“新下载线程启动”消息后会收到本消息，本消息说明了新下载线程的下载范围。注意：本消息是在与服务器交互完毕后，准备下载数据前产生的，本消息可以用来确定正式开始接收数据。 枚举常量值“系统处理”所处集合数据类型为“传送常量”，值为0。 系统自动改名，如已经存在同名文件“file.exe”，将自动更名为“file(1).exe”，如果发现“file(1).exe”也存在则括号中的数字加1，即“file(2).exe”，直到“file(99).exe”为止。 枚举常量值“结束下载”所处集合数据类型为“传送常量”，值为1。 当收到“存在同名文件”时使用。用来结束下载线程。 枚举常量值“设置新名”所处集合数据类型为“传送常量”，值为2。 当收到“存在同名文件”时使用。如果返回本值，那么需要在回调函数返回前调用下载对象中的“设新文件名”。 枚举常量值“存在同名文件”所处集合数据类型为“传送常量”，值为18。 当下载对象创建本地文件时，发现已存在的同名文件时系统发送本消息通知用户。回调函数的参数3为已存在文件的大小，回调函数的参数4为待下载文件的大小。本消息有返回值，可以为以下常量 #系统处理，#结束下载，#设置新名。