身份证阅读器SDK使用手册
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
身份证阅读器SDK使用手册
V1.00
2007年3月
概述
本手册是操作身份证阅读器动态库应用函数的定义格式、调用方法和返回值的说明。在使用前,请确认授权文件termb.lic是否在你的PC机C:\根目录下。
1.定义
应用函数开发包含下列文件:
termb.h API函数原型定义
termb.lib API函数的C++Builder开发包
termb.dll API函数的动态联接库
sdtapi.dll 内部动态库
cvrapi.dll 内部动态库
wltrs.dll 内部动态库
termb.lic 身份证相片解压授权文件,放于C:\目录下
适用操作系统:
Windows NT: 需要NT 3.1版或以后版本
Windows: 需要 Windows 98、Windows 2000或以后版本
适用开发语言:
Visual C++ 5.0 及以后版本
Visual Basic 5.0 及以后版本
DEPHI 3.0 及以后版本
PowerBuilder 6.0 及以后版本
2.函数列表
int CVR_InitComm(int Port) 初始化连接;
int CVR_Authenticate() 卡认证;
int CVR_Read_Content(int Active) 读卡操作。
int CVR_CloseComm() 关闭连接;
int CVR_Ant(int mode) 射频操作
3.函数调用流程
4.函数说明
4.1初始化连接
原型:int CVR_InitComm (int Port)
说明:本函数用于PC与华视电子第二代居民身份证阅读器的连接。
参数:Port:连接串口或USB口
返回值:
4.2关闭串口
原型:
int CVR_CloseComm(void)
说明:本函数用于关闭PC到阅读器的连接。
参数:无
返回值:
4.3卡认证
原型:int CVR_Authenticate (void)
说明:本函数用于读卡器和卡片之间的合法身份确认。
参数:
返回
注意:若卡片放置后发生认证错误时,应移走卡片重新放置。
4.4读卡操作
原型:int CVR_Read_Content(int Active);
说明:本函数用于通过阅读器从第二代居民身份证中读取相应信息。
返回值:
4.5射频操作
原型:int CVR_Ant(int mode);
说明:本函数用于打开/关闭射频。阅读器在不读卡时,如果射频对其它的电子产品有干扰的话,可以选择关闭射频,当需要读卡时,再打开射频。该函数只
在当连接到串行接口的阅读器时,调用有效。如不调用此函数时,射频一直
处于打开状态。
注:当CVR_InitComm函数调用成功后,该函数有效。
参数:mode
返回值:
注意:若采用查询方式自动判断卡片是否放置,则间隔时间建议大于300ms。
注意:
1、读完基本信息后,若需要立即读取最新住址信息或芯片管理号,在未移走卡
片的情况下可以不用卡认证;
2、单独读取最新住址信息或芯片管理号时,需要先进行卡认证;
3、若卡片放置后发生读卡错误时,应移走卡片重新放置。
文字信息采用GB 13000的UCS-2进行存储,各项目分配如下: