华视身份证阅读器SDK使用手册
来源:互联网 发布:淘宝企业店铺申请流程 编辑:程序博客网 时间:2024/05/17 05:58
华视身份证阅读器SDK使用手册
V1.33
华视电子读写设备有限公司
2008年07月11日
概述
本手册是操作身份证阅读器动态库应用函数的定义格式、调用方法和返回值的说明。在使用前,请确认授权文件termb.lic是否在你的PC机C:/根目录下。
1. 定义
应用函数开发包含下列文件:
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 及以后版本
Delphi 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) 射频操作
int CVR_ReadBaseMsg (
unsigned char *pucCHMsg, unsigned int *puiCHMsgLen, unsigned char *pucPHMsg, unsigned int *puiPHMsgLen,
int nMode) 读卡操作(读入内存)
int GetPeopleName(char *strTmp, int *strLen) 得到姓名信息
int GetPeopleSex(char *strTmp, int *strLen) 得到性别信息
int GetPeopleNation(char *strTmp, int *strLen) 得到民族信息
int GetPeopleBirthday(char *strTmp, int *strLen) 得到出生日期
int GetPeopleAddress(char *strTmp, int *strLen) 得到地址信息
int GetPeopleIDCode(char *strTmp, int *strLen) 得到身份证号信息
int GetDepartment(char *strTmp, int *strLen) 得到发证机关信息
int GetStartDate(char *strTmp, int *strLen) 得到有效开始日期
int GetEndDate(char *strTmp, int *strLen) 得到有效截止日期
3. 函数调用流程
4. 函数说明
4.1 初始化连接
原 型:int CVR_InitComm (int Port)
说 明:本函数用于PC与华视电子第二代居民身份证阅读器的连接。
参 数:Port:连接串口或USB口
值
意义
1
串口1
2
串口2
3
串口3
4
串口4
1001
USB口1
1002
USB口2
1003
USB口3
1004
USB口4
返回值:
值
意义
1
正确
0
错误
4.2 关闭串口
原 型:
int CVR_CloseComm(void)
说 明:本函数用于关闭PC到阅读器的连接。
参 数:无
返回值:
值
意义
1
正确
0
错误
4.3 卡认证
原 型:int CVR_Authenticate (void)
说 明:本函数用于读卡器和卡片之间的合法身份确认。
参 数:
返回值:
值
意义
说明
1
正确
卡片正确放置时
0
错误
未放卡或卡片放置不正确时
注意:若卡片放置后发生认证错误时,应移走卡片重新放置。
4.4 读卡操作
原 型:int CVR_Read_Content(int Active);
说 明:本函数用于通过阅读器从第二代居民身份证中读取相应信息。
参 数:Active 读取信息类型
Active
意义
说明
1
读基本信息
生成文字WZ.TXT、相片数据XP.WLT和相片ZP.BMP(解码)
2
读基本信息
生成文字WZ.TXT和相片数据XP.WLT
3
读最新住址信息
生成最新住址NEWADD.TXT(卡无最新地址则生成空文件)
4
读基本信息
生成WZ.TXT(解码),相片ZP.BMP(解码)
5
读芯片管理号
芯片管理号IINSNDN.bin
6
读基本信息
以设备唯一标志号,生成文字WZ.TXT(解码),相片XP.BMP(解码)
(用于终端网络环境)
返回值:
返回值
意义
1
正确
0
错误
4.5 射频操作
原 型:int CVR_Ant(int mode);
说 明:本函数用于打开/关闭射频。阅读器在不读卡时,如果射频对其它的电子产品有干扰的话,可以选择关闭射频,当需要读卡时,再打开射频。该函数只在当连接到串行接口的阅读器时,调用有效。如不调用此函数时,射频一直处于打开状态。
注:当 CVR_InitComm函数调用成功后,该函数有效。
参 数:mode
MODE
意义
0
关闭射频
1
打开射频
返回值:
返回值
意义
1
正确
0
错误
4.6 读文字、照片信息到自定义内存缓冲
原 型:int CVR_ReadBaseMsg (unsigned char *pucCHMsg, unsigned int *puiCHMsgLen, unsigned char *pucPHMsg, unsigned int *puiPHMsgLen,
int nMode)
说 明:此函数代替CVR_Read_Content函数,将身份信息读到自定义内存缓冲中。卡 认证CVR_Authenticate成功以后调用本函数。
参 数:
参数
说明
备注
pucCHMsg
身份文字信息内存缓冲指针
方向:Out
puiCHMsgLen
身份文字信息长度
默认 256 Byte
pucPHMsg
身份照片信息内存缓冲指针
方向:Out
puiPHMsgLen
身份照片信息长度
默认 1024 Byte
nMode
传入参数1
文字编码为默认UCS-2格式,
照片未解压成bmp文件
传入参数2
文字编码已转换成GBK国标码格式,
照片未解压成bmp文件
传入参数3
文字编码为默认UCS-2格式,
照片已解压成zp.bmp文件
传入参数4
文字编码已转换成GBK国标码格式,
照片已解压成zp.bmp文件
返回值:
返回值
意义
1
正确
0
错误
4.7 读各项文字信息到自定义内存缓冲
原 型:
int _stdcall GetPeopleName(char *strTmp, int *strLen) //得到姓名信息
int _stdcall GetPeopleSex(char *strTmp, int *strLen) //得到性别信息
int _stdcall GetPeopleNation(char *strTmp, int *strLen) //得到民族信息
int _stdcall GetPeopleBirthday(char *strTmp, int *strLen) //得到出生日期
int _stdcall GetPeopleAddress(char *strTmp, int *strLen) //得到地址信息
int _stdcall GetPeopleIDCode(char *strTmp, int *strLen) //得到卡号信息
int _stdcall GetDepartment(char *strTmp, int *strLen) //得到发证机关信息
int _stdcall GetStartDate(char *strTmp, int *strLen) //得到有效开始日期
int _stdcall GetEndDate(char *strTmp, int *strLen) //得到有效截止日期
说 明:以上函数调用流程为:调用 CVR_Read_Content 或者 CVR_ReadBaseMsg 函数 成功后再分别调用以上函数。CVR_Read_Content 或者 CVR_ReadBaseMsg 函数 自动 在应用程序当前目录产生BMP照片文件。
参数:
*strTmp 返回的信息缓存指针。
*strLen 返回的信息长度指针。
返回值:
返回值
意义
1
正确
0
错误
注意:若采用查询方式自动判断卡片是否放置,则间隔时间建议大于300ms。
注意:
1、 读完基本信息后,若需要立即读取最新住址信息或芯片管理号,在未移走卡片的情况下可以不用卡认证;
2、 单独读取最新住址信息或芯片管理号时,需要先进行卡认证;
3、若卡片放置后发生读卡错误时,应移走卡片重新放置。
文字信息采用GB 13000的UCS-2进行存储,各项目分配如下:
项目
长度(字节)
说明
姓名
30
汉字
性别
2
代码
民族
4
代码
出生
16
年月日:YYYYMMDD
住址
70
汉字和数字
公民身份号码
36
数字
签发机关
30
汉字
有效期起始日期
16
年月日:YYYYMMDD
有效期截止日期
16
年月日:YYYYMMDD
有效期为长期时存储“长期”
最新住址
70
汉字和数字
芯片管理号分配如下:
项目
长度(字节)
说明
IIN
4
SN
8
DN
16
- 华视身份证阅读器SDK使用手册
- 最近的项目中用到读卡器,用的华视身份证阅读器,附上SDK使用手册
- 华视cvr-100UC 二代身份证读卡通用函数
- 身份证阅读器代码C#
- 身份证阅读器在人事管理中的運用
- 身份证阅读器读相片经常一片白色
- delphi 二代身份证阅读器开发 SDT_ReadBaseMsg函数
- Android身份证拍照识别SDK
- Android拍照识别身份证SDK
- 证件身份证识别设备SDK
- 身份证服务器云识别SDK
- 身份证拍照识别软件SDK
- 身份证扫描的功能sdk
- 客户端SDK开发使用手册 概述
- 公安部中标十大身份证阅读器品牌型号
- 护照阅读器技术的应用场景SDK
- 身份证识别SDK-身份证识别api(移动端-服务器端)
- 身份证识别SDK-身份证识别api(移动端-服务器端)
- Linux--根文件系统的挂载过程分析
- tabpanel选择页签在下面选择,并有前进后退按钮
- 我的dota之路(下)
- mysql生成数据库结构图
- mapcrunch 带你全球免费旅游,足不出户看遍全世界的乡村美景!
- 华视身份证阅读器SDK使用手册
- Linux--Sys_Read系统调用过程分析
- 从日常代码质量检查工作中感受工作中的乐趣、生活的乐趣
- Android应用程序开发环境的建立
- Android入门第十三篇之Gallery + ImageSwitcher
- iphone开发4 一些小贴士。
- Ruby gem 更新错误解决方案
- 我的博后申请经历从陶瓷到Offer过程
- 手把手教你配置OGRE v1.7