PDF《郑州商品交易所》

郑州商品交易所 ZCEAPI 使用手册 (2017) Version1.

1.3.3 郑州商品交易所

2017 年08 月II 郑州商品交易所 ZCEAPI 使用手册 I 目录 0. 修改历史.1 1. 概述.3 1.1 目的及说明.3 1.2 相关文档.3 1.3 ZCEAPI 简介.3 1.4 ZCEAPI 所处位置.3 1.5 ZCEAPI 通信简介.4 1.6 ZCEAPI 使用环境.4 1.7 ZCEAPI 相关文件说明.5 2. ZCEAPI 使用说明.5 2.1 使用概述.5 2.2 线程模式简介.6 2.3 基本过程.6 2.3.1 ZCEAPI 初始化.6 2.3.2 创建连接交易所对象.7 2.3.3 设置链路的回调函数.7 2.3.3.1 定义回调函数.8 2.3.3.2 设置回调函数.9 2.3.4 连接交易所.9 2.3.5 登录交易所.10 2.3.6 读写数据包.12 2.3.7 遍历数据包.13 2.3.8 发送数据包.13 2.3.9 数据的接收.15 2.3.10 退出登录.15 2.3.11 释放链路连接.17 2.3.12 停止 ZCEAPI 服务.17

3 数据定义.17 3.1 基础数据类型.17 3.2 日期时间类型.17 3.3 API_BOOL.18 3.4 线程模式.18 3.5 建立连接时是否阻塞.18 3.6 市场约定.18 3.7 数据域类型定义.18 3.8 数据流标示.18 3.9 数据流状态常数.19 3.10 数据包句柄.19 3.11 连接对象句柄.19 3.12 返回数据包回调函数.19 3.13 链路状态回调函数.19 郑州商品交易所 ZCEAPI 使用手册 II 4. 函数介绍.20 4.1 ZCEAPI 管理.20 4.1.1 获取 ZCEAPI 版本号.20 4.1.2 ZCEAPI 初始化.20 4.1.3 停止 ZCEAPI 服务.21 4.2 数据包管理.21 4.2.1 创建数据包对象.21 4.2.2 回收数据包对象.21 4.3 报文数据操作.21 4.3.1 取得报文 ID.21 4.3.2 设置报文 ID.22 4.3.3 取得某字段的当前数据类型.22 4.4 字段操作.22 4.4.1 从数据包中取字符.22 4.4.2 设置数据包中的字符数据域.23 4.4.3 从数据包中取整数.23 4.4.4 设置数据包中的整型数据域.24 4.4.5 从数据包中取双精度小数.24 4.4.6 设置数据包中的双精度数据域.25 4.4.7 从数据包中取字符串.26 4.4.8 设置数据包中的字符串数据域.27 4.4.9 从数据包中取日期时间.27 4.4.10 设置数据包中的日期时间数据域.28 4.4.11 判断某个字段是否为空.28 4.4.12 清除某个特定的字段的值.29 4.4.13 清除数据包里的所有字段.29 4.4.14 数据包复制.29 4.5 数据遍历.30 4.5.1 数据包的数据域指针移到第一个数据域.30 4.5.2 下一个数据域.30 4.5.3 取当前数据域类型.30 4.5.4 取当前数据域的时间.31 4.5.5 取当前数据域的字符.31 4.5.6 取当前数据域的整数.31 4.5.7 取当前数据域的浮点数.32 4.5.8 取得当前数据域的字符串.32 4.5.9 取当前时间.33 4.6 连接管理.33 4.6.1 创建交易所连接对象.33 4.6.2 设置连接属性参数.33 4.6.3 发起与交易所连接.34 4.6.4 通过域名服务器发起与交易所的连接.34 4.6.5 是否已经连接.35 4.6.6 登录到交易所.35 郑州商品交易所 ZCEAPI 使用手册 III 4.6.7 退出登录.36 4.6.8 发送一个数据包.36 4.6.9 接收一个数据包.37 4.6.10 断开与交易所的连接.37 4.6.11 关闭并释放交易所连接对象.37 4.6.12 取得数据流状态.37 4.7 设置回调函数.38 4.7.1 设置连接打开通知.38 4.7.2 设置连接断开通知.38 4.7.3 设置出错通知.39 4.7.4 设置接收数据通知.39 4.7.5 设置登录应答通知.39 4.7.6 设置退出登录应答通知.40 郑州商品交易所 ZCEAPI 使用手册

1 0. 修改历史 API 版本 修改时间 修改内容 说明 1.1.3.3 2017-08-01 1) 增加 Linux 平台下库文件说明及其使用说 明. 2) 修订支持郑商所域名解析功能API_ConnectEx 函数的参数说明. 3) 修订使用部分, 说明 API 目前只支持多线程 模式. 4) 修改 1.5 章节中关于私有流的说明,删掉私 有流接收对话流的请求应答包的描述. 5) 修改 1.6 章节中新版 ZCEAPI 做过兼容性测 试的平台列表. 6) 删除一些无关冗余文字,精简使用描述. 7) 修改使用环境等时效性较强的说明. 8) 针对Linux 平台上的使用,新增对API_SetConnectionOpt 接口的说明. 适应新版修改;