神思第二代身份证验证机具
ActiveX 控件使用说明
版本:V3.0.0.2
神思电子技术有限公司
2018 年 10 月
神思第二代身份证验证机具 ActiveX 控件使用说明
修订记录
版本号 日期 章节号 简单描述 修订者 审核者
1.0 2007.6.12
初始创建 谭雪欣
1.0.55.0 2008.7.25
增加部分函数 谭雪欣
1.0.57.0 2008.9.8
修改了同时打开多个页面,关闭出
错问题。
谭雪欣
1.0.58.0 2008-09-12
增加了 wlt 图片的 buffer 属性等。 谭雪欣
1.0.72.0 2008-11-12
增加手动读卡时读卡失败则清空卡
面信息,打开界面自动开始读卡,
身份证反正面为横版。
谭雪欣
1.0.77.0 2008-11-13
增加保存身份证反正面图片函数等 谭雪欣
1.0.81.0 2008-11-25
增加安全模块号的读取 谭雪欣
1.0.82.0 2009-3-3
修改身份证图片生成 temp 文件夹
下
谭雪欣
1.0.83.0 2009-3-10
增加清空属性的函数 谭雪欣
1.0.85.0 2009-5-31
用户自定义图片存放路径。 谭雪欣
1.0.87.0 2009-08-27
增加身份证正反面的单独保存 陈金华
1.0.97 2009-09-09
增加临时文件自定义保存目录、配
置文件 ini 存放在 c 盘根目录低下
陈金华
1.1.0.0 2010-11-19
Win7,IE8 下界面显示黑框,修改
源码,并去掉界面对于按钮,只显
示身份证正面和签发机关、有效期
限、最新住址。
谭雪欣
1.2.0.0 2010-11-23
增 加 属 性 szCardInfo , 方 法
readrfcard
谭雪欣
1.3.0.0 2010-11-30
整理界面,更换最新 rdcard2.0 谭雪欣
1.3.5.0 2011-11-01
增加 AxCtrls 单元,避免打开多个后,
关闭错误;并数字签名;
谭雪欣
1.3.6.0 2013-10-26
更换 RDCard 动态库 2.3,使串口读
卡更快;增加事件(打开机具成功
后事件,读卡成功后事件,关闭机
具成功后事件等)修改读模块号函
数返回值,直接返回字符串;去掉
一些无用的属性,增加读指纹特征
值,指纹质量,指位信息;
谭雪欣
1.3.6.1 2014-01-08
判断保存图片路径不存在或者为空 谭雪欣
第 2 页
神思第二代身份证验证机具 ActiveX 控件使用说明
1.3.6.2 2014-02-11
增加保存头像和正反面图片的函数 谭雪欣
1.3.6.3 2014-07-16
生成头像和正反面 bmp 图片 谭雪欣
1/3/6/4 2016-10-11
外部设置串口号、波特率、
2.0.2 2017-09-30
用 C 重写原 Delphi 控件,增加外国
人永久居留证的支持。
马兆瑞
3.0.0.1 2018-08-28
增加港澳台居民居住证支持 许雪雪
3.0.0.2 2018-10-23
增加港澳台居民居住证正反面照片 许雪雪
第 3 页
神思第二代身份证验证机具 ActiveX 控件使用说明
目 录
说明..................................................................................................................................................................6
1、控件事件....................................................................................................................................................6
1.1 打开机具成功事件..............................................................................................................................6
1.2 读卡成功事件......................................................................................................................................6
1.3 关闭机具成功事件..............................................................................................................................6
2、控件方法....................................................................................................................................................6
2.1 打开端口连接设备..............................................................................................................................6
2.2 关闭端口断开设备..............................................................................................................................7
2.3 检测连接方法......................................................................................................................................7
2.4 读取证件信息......................................................................................................................................7
2.5 自动读取信息......................................................................................................................................7
2.6 结束自动读卡......................................................................................................................................7
2.7 删除读卡过程中生成的任意文件......................................................................................................8
2.8 清空所有属性.......................................................................................................................................8
2.9 保存身份证正反面图片......................................................................................................................8
2.10 保存身份证头像和正反面图片........................................................................................................8
2.11 保存身份证头像 BMP 图片和正反面 BMP 图片............................................................................9
2.11 读取设备安全模块号.........................................................................................................................9
错误代码表................................................................................................................................................9
3、控件属性..................................................................................................................................................10
3.1 姓名....................................................................................................................................................10
3.2 性别....................................................................................................................................................10
3.3 民族....................................................................................................................................................10
3.4 出生日期............................................................................................................................................10
3.5 住址.....................................................................................................................................................11
3.6 公民身份号码....................................................................................................................................11
3.7 签发机关.............................................................................................................................................11
3.8 有效期限.............................................................................................................................................11
3.9 有效期限起始日期............................................................................................................................11
3.10 有效期限截止日期..........................................................................................................................12
3.11 最新地址...........................................................................................................................................12
3.12 JPG 照片存放路径_反斜杠.............................................................................................................12
3.13 BMP 照片存放路径_反斜杠...........................................................................................................12
3.14 JPG 照片存放路径...........................................................................................................................12
3.15 BMP 照片存放路径.........................................................................................................................13
3.16 JPG 照片的 Base64 编码字符串.....................................................................................................13
3.17 BMP 照片的 Base64 编码字符串...................................................................................................13
3.18 WLT 照片的 Base64 编码字符串....................................................................................................13
3.19 身份证文本信息存放路径文件名..................................................................................................13
3.20 身份证正面 JPG 照片的 Base64 编码字符串................................................................................13
第 4 页
神思第二代身份证验证机具 ActiveX 控件使用说明
3.21 身份证反面 JPG 照片的 Base64 编码字符串................................................................................14
3.22 身份证临时文件保存目录..............................................................................................................14
3.23 有数据标志......................................................................................................................................14
3.24 控件状态标志..................................................................................................................................14
3.25 控件下载后是否处于自动读卡状态..............................................................................................14
3.26 设备安全模块号..............................................................................................................................14
3.27 端口号码...........................................................................................................................................15
3.28 端口波特率.......................................................................................................................................15
3.29 指纹特征值.......................................................................................................................................15
3.30 指位信息...........................................................................................................................................15
3.31 指纹质量...........................................................................................................................................16
3.32 指纹注册结果..................................................................................................................................16
3.33 证件类型标识..................................................................................................................................17
3.34 证件版本号.......................................................................................................................................17
3.35 通行证号码.......................................................................................................................................17
3.36 签发次数...........................................................................................................................................17
附:二代身份证与外国人永久居留证与港澳台居民居住证属性信息对照表.................................17
4、示例网页使用说明............................................................................................................................19
5、支持标准串口阅读器说明................................................................................................................20
第 5 页