dataapi接口使用指南.docVIP

目 录 1 dataapi接口概述 1 2 dataapi接口技术说明 1 3 dataapi接口安装 2 4 dataapi接口函数详述 2 4.1 Connect 2 4.2 Disconnect 4 4.3 DataQuery 4 4.4 DataCount 8 4.5 DataAppend 9 4.6 DataUpdate 12 4.7 DataDelete 13 4.8 InfoQuery 14 4.9 InfoUpdate 16 4.10 GetRTLog 17 5 附录 21 5.1 附录1：接口文件的详细说明 21 5.2 附录2：demo演示程序的安装、使用指南 21 5.3 附录3：dataapi接口函数出错说明一览 23 5.4 附录4：dataapi接口使用的数据表示、表、字段等一览 24 6 FAQ 32 6.1 编译VC下的Demo及RTime程序时，出现 ：“fatal error C1083: Cannot open include file: vld.h: No such file or directory”连接错误： 32 6.2 编译Jave Demo下的commprojava(VC DLL)工程时出现：“fatal error C1083: Cannot open include file: jni.h: No such file or directory”连接错误： 32 6.3 使用彩屏机对一个用户表查询时：DataQuery(h, (char *)bufOut, 2 * 1024 *1024, “UserInfo”, “*”, “PIN6666”, “”)，过滤条件为: “PIN6666”,即准备查询考勤号大于6666的人员，为何下列记录会返回？ 32 6.4 当使用GPRS、串口连接时，Append很多指纹数据时非常慢，如何解决？ 33 6.5 使用RS232、RS485、UDP连接失败？ 33 6.6 使用RS232、RS485、UDP连接查询、追加操作时，经常返回-902错误？ 34 Dataapi接口使用指南 1 dataapi接口概述 Dataapi接口是一组功能函数，是在原有脱机通信开发包SDK接口之上，扩展出的另一组函数接口，可以取代原有通信开发包SDK中对考勤机设备控制、数据访问的功能，但使最终应用程序开发用户在访问考勤机时，更直观、更方便、更简洁。Dataapi接口完成的功能有： 查询、计数、追加、更新、删除考勤机内与考勤用户有关的信息； 查询、计数、追加、更新、删除机内指纹相关的数据； 查询、计数、删除机内用户考勤记录数据； 查询、计数、追加、更新、删除考勤机内短信表的数据； 查询、计数、追加、更新、删除考勤机内工作表的数据； 查询、计数、删除机内管理记录数据； 查询、修改考勤机设备有关的信息。 2 dataapi接口技术说明 Dataapi接口使最终应用程序开发用户看起来是一组对考勤机内数据Set/Get的抽象接口，在具体访问考勤用户数据时，类似于在使用最通用的SQL语句。Dataapi接口在应用程序开发用户眼中看起来更像一个数据库服务器； Dataapi接口独立于HTTP、UDP、RS232/485通信协议，实现了与通信协议无关。因此该接口适用于目前任何物理连接形式的考勤机； Dataapi接口仅在访问时，和终端访问PC建立连接一次连接，使用完毕后，连接自动断开。因此，该接口在连接上更安全，更适合业务模型； Dataapi接口程序实现在考勤机内为C语言，在应用程序程序开发端（PC机）采用C语言封装的动态链接库，做到了最高效的访问接口； Dataapi接口在设计伊始参考了SQL，但更考虑到业务中最常用的模型，是精心提炼出来的一组接口，做到了设计、实现、使用三方的平衡。 3 dataapi接口安装 Dataapi接口函数存在于文件commpro.dll中，该库依赖于其他几个文件，需要将下列DLL文件一同拷贝到windows下的系统目录（windows XP下为windows/system32）：（含Demo的目录是演示程序如何编写，不要拷贝到系统目录） （注：① 每个文件功能描述见附录1，② 当收到中控科技更新版本的动态库时，注意先将系统目录下的原文件删除，确认删掉后，再拷贝更新版本的DLL）。 含demo的目录是三种流行语言的开发演示程序，均附有源码及丰富的注释，如何正确成功编译它们，参见附录2。 4 dataapi接口函数详述 4.1 Connect [函数] DLLIMPORT void * __stdcall Connect(const char *Parameters); [功能] 连接到设备，连