当前位置:
文档之家› 身份证阅读器SDK使用手册1
身份证阅读器SDK使用手册1
华视电子读写设备有限公司 5 之 7
传入参数 2 传入参数 3 传入参数 4
返 回 值:
返回值 1 0
身份证阅读器 SDK 使用手册
文字编码已转换成 GBK 国标码格式, 照片未解压成 bmp 文件 文字编码为默认 UCS-2 格式, 照片已解压成 zp.bmp 文件 文字编码已转换成 GBK 国标码格式, 照片已解压成 zp.bmp 文件
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 (
意义 正确 错误
4.7 读各项文字信息到自定义内存缓冲
原 型:
int _stdcall GetPeopleName(char *strTmp, int strLen)
//得到姓名信息
int _stdcall GetPeopleSex(char *strTmp, int strLen)
//得到性别信息
参 数:
返 回 值:
值
意义
说明
1
正确
卡片正确放置时
0
错误
未放卡或卡片放置不正确时
注意:若卡片放置后发生认证错误时,应移走卡片重新放置。
4.4 读卡操作
原 型:int CVR_Read_Content(int Active);
说 明:本函数用于通过阅读器从第二代居民身份证中读取相应信息。
参 数:Active 读取信息类型
3. 函数调用流程
开始
初始化连接
身份证阅读器 SDK 使用手册
得到有效开始日期 得到有效截止日期
读卡器认证
打开射频
读卡信息
CVR_ReadBaseMsg
关闭射频
关闭连接
结束
4. 函数说明
4.1 初始化连接 原 型:int CVR_InitComm (int Port)
华视电子读写设备有限公司 3 之 7
Active 1 2 3
意义 读基本信息 读基本信息 读最新住址信息
说明
生成文字 WZ.TXT、相片数据 XP.WLT 和相片 ZP.BMP(解码) 生成文字 WZ.TXT 和相片数据 XP.WLT 生成最新住址 NEWADD.TXT(卡无最新地址则生成空文件)
华视电子读写设备有限公司 4 之 7
身份证阅读器 SDK 使用手册
int _stdcall GetPeopleNation(char *strTmp, int strLen) //得到民族信息
int _stdcall GetPeopleBirthday(char *strTmp, int strLen) //得到出生日期
int _stdcall GetPeopleAddress(char *strTmp, int strLen) //得到地址信息
有效期截止日期
16
年月日:YYYYMMDD
有效期为长期时存储“长期”
最新住址
70
汉字和数字
芯片管理号分配如下: 项目 IIN SN DN
长度(字节) 4 8 16
说明
华视电子读写设备有限公司 7 之 7
参 数:
参数 pucCHMsg puiCHMsgLen pucPHMsg puiPHMsgLen nMode
说明 身份文字信息内存缓冲指针 身份文字信息长度 身份照片信息内存缓冲指针 身份照片信息长度 传入参数 1
备注
方向:Out 默认 256 Byte 方向:Out 默认 1024 Byte 文字编码为默认 UCS-2 格式, 照片未解压成 bmp 文件
返 回 值:
值
意义
1
正确
0
错误
4.2 关闭串口
原 型:
int CVR_CloseComm(void)
说 明:本函数用于关闭 PC 到阅读器的连接。ຫໍສະໝຸດ 参 数:无返 回 值:
值
意义
1
正确
0
错误
4.3 卡认证
原 型:int CVR_Authenticate (void)
说 明:本函数用于读卡器和卡片之间的合法身份确认。
身份证阅读器 SDK 使用手册
说 明:本函数用于 PC 与华视电子第二代居民身份证阅读器的连接。
参 数:Port:连接串口或 USB 口
值 1 2 3 4 1001 1002 1003 1004
意义
串口 1 串口 2 串口 3 串口 4 USB 口 1 USB 口 2 USB 口 3 USB 口 4
初始化连接; 卡认证; 读卡操作。 关闭连接; 射频操作
读卡操作(读入内存) 得到姓名信息 得到性别信息 得到民族信息 得到出生日期 得到地址信息 得到身份证号信息 得到发证机关信息
华视电子读写设备有限公司 2 之 7
int GetStartDate(char *strTmp, int strLen) int GetEndDate(char *strTmp, int strLen)
适用操作系统:
Windows NT: 需要 NT 3.1 版或以后版本
Windows: 需要 Windows 98、Windows 2000 或以后版本
适用开发语言:
Visual C++ 5.0 及以后版本
Visual Basic 5.0 及以后版本
Delphi
3.0 及以后版本
PowerBuilder 6.0 及以后版本
int _stdcall GetPeopleIDCode(char *strTmp, int strLen) //得到卡号信息
int _stdcall GetDepartment(char *strTmp, int strLen)
//得到发证机关信息
int _stdcall GetStartDate(char *strTmp, int strLen)
函数 自动在应用程序当前目录产生 BMP 照片文件。
返 回 值:
返回值 1 0
意义 正确 错误
注意:若采用查询方式自动判断卡片是否放置,则间隔时间建议大于 300ms。
注意: 1、 读完基本信息后,若需要立即读取最新住址信息或芯片管理号,在未移走卡
片的情况下可以不用卡认证; 2、 单独读取最新住址信息或芯片管理号时,需要先进行卡认证; 3、若卡片放置后发生读卡错误时,应移走卡片重新放置。
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
身份证阅读器 SDK 使用手册
身份证阅读器 SDK 使用手册 V1.26
华视电子读写设备有限公司
2008 年 02 月 25 日
华视电子读写设备有限公司 1 之 7
身份证阅读器 SDK 使用手册
概述
本手册是操作身份证阅读器动态库应用函数的定义格式、调用方法和返回值的说明。在 使用前,请确认授权文件 termb.lic 是否在你的 PC 机 C:\根目录下。
华视电子读写设备有限公司 6 之 7
身份证阅读器 SDK 使用手册
文字信息采用 GB 13000 的 UCS-2 进行存储,各项目分配如下:
项目
长度(字节)
说明
姓名
30
汉字
性别
2
代码
民族
4
代码
出生
16
年月日:YYYYMMDD
住址
70
汉字和数字
公民身份号码
36
数字
签发机关
30
汉字
有效期起始日期
16
年月日:YYYYMMDD
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 成功以后调用本函数。
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)