企业自助服务终端设备软件接口需求.doc

附件： 企业自助服务终端设备软件接口需求 中国建设银行股份有限公司四川省分行 2012年7月目 录 一、 设备监控查询接口需求 1 二、 打印纸槽设定接口需求 2 三、 RF卡读卡接口需求 2 四、 磁条卡读卡接口需求 3 五、 打印情况反馈接口需求 4 六、 密码键盘输入接口需求 6 七、 接口需求说明 7 Errmsg：出错时存放错误信息 返回值： 关闭磁卡入口成功 非0 关闭磁卡入口失败 获取磁卡位置 （1）dll文件名：Recp_readcard_mg.dll （2）dll 函数定义: int checkcardposition(int position,char *errmsg) （3）函数返回信息： position 1： 无卡 2： 腹部 3： 前端夹卡位置 4： 前端不夹卡位置(不作强制要求) 5： 其他 Errmsg：出错时存放错误信息 备注：如果不能区分3，4;3，4就合并为前端 返回值： 0：正确 非0：失败 关闭串口 （1）dll文件名：Recp_readcard_mg.dll （2）dll 函数定义: int closecomm (char *errmsg) （3）函数返回信息： 返回值： 0 关闭串口成功 非0 关闭串口失败 打印情况反馈接口需求 1. 接口功能：自助设备需要提供一个基于dll的api函数用于获取最近一次打印的情况。 2. api需求： 初始化成功张数 （1）dll文件名：Recp_getprinterinfo.dll （2）dll函数定义：int start() （3）函数返回值： 0——表示初始化成功 －1——函数内部出错 统计成功张数 （1）dll文件名：Recp_getprinterinfo.dll （2）dll函数定义：int get_success_counts(char *errmsg) 参数说明： Errmsg：出错时存放错误信息 （3）函数返回值： 整数——表示成功打印的张数 －1——函数内部出错 清除打印队列 （1）dll文件名：Recp_getprinterinfo.dll （2）dll函数定义：int clear_list(char *errmsg) 参数说明： Errmsg：出错时存放错误信息 （3）函数返回值： 0——清除成功 －1——函数内部出错 预热打印机 （1）dll文件名：Recp_getprinterinfo.dll （2）dll函数定义：int prepare_printer(char *errmsg) 参数说明： Errmsg：出错时存放错误信息 （3）函数返回值： 0——预热成功 －1——函数内部出错 密码键盘输入接口需求 1. 接口功能：系统提供的密码键盘需要按照我行的加密要求实现硬件加密。 2. 密码键盘接口需求： 密码长度获取接口 （1）dll函数定义：int GetCurrentChars(char * errmsg) （2）函数返回值： =0——调用成功，返回当前输入的字符数 -1——调用失败 （3）备注：该接口的目的是为了获得当前已经输入了多少个字符，如用户键盘点击了 1,2,3 调用接口则返回3，点击“清除”键后，调用该接口返回 2。 取消输入 （1）dll函数定义：int abortgetpassword (char * errmsg) （2）函数返回值： 0——调用成功 -1——调用失败 （3）备注：终止当前键盘输入，之前约定调用getpassword处于阻塞的状态，如果调用abortgetpassword函数后，需将getpassword直接返回,返回值为空串。 密码键盘模式切换 （1）Dll 函数定义 int setnormalbord(char *errmsg) （2）函数返回值： 0：调用成功 -1：调用失败 （3）备注： errmsg: 出错信息 接口需求说明 以上是目前系统运行所需接口需求，随着后期项目进一步推进，将可能要求设备厂商提供更多接口支持，设备厂商应保证相关技术人员配备，具备完成后续相关接口开放调试的能力。 申明：本资料仅供各设备供应商了解此次采购需求，未经我行同意，不得将本资料中信息泄露给任何第三方或用于其他目的，否则，我行将追究其法律责任。 8