第二代居民身份证termb.dll应用开发使用手册

第二代居民身份证阅读器GTICR-100

函数包使用手册

成都国腾 2005.4

第二代居民身份证阅读器GTICR-100函数包使用手册

文档控制

文档更新记录

文 档 编 号： 本次修改日期：2005.04.19 历史修改累记：2 编制单位 审核单位 审核主管 产品部 总工办 技术总监

地址：成都市高新西区国腾园3号楼3楼 邮编：611731 电话：（028）87825723 http：//www.szgoldtel.com.cn 传真：（028）87825734 E－mail：szgt@ guoteng.com.cn

第 2 页 共 16 页

第二代居民身份证阅读器GTICR-100函数包使用手册

目 录

1 2 3 4 5 6 7

概述 .................................................................................................................................................. 4 定义 .................................................................................................................................................. 4 函数列表 .......................................................................................................................................... 4 函数调用流程 .................................................................................................................................. 6 函数说明 .......................................................................................................................................... 6 用户信息函数组使用时的调用顺序说明 .................................................................................... 11 一个完整的示例： ........................................................................................................................ 12

地址：成都市高新西区国腾园3号楼3楼 邮编：611731 电话：（028）87825723 http：//www.szgoldtel.com.cn 传真：（028）87825734 E－mail：szgt@ guoteng.com.cn

第 3 页 共 16 页

第二代居民身份证阅读器GTICR-100函数包使用手册

1 概述

本手册是操作身份证阅读器应用函数的定义格式、调用方法和返回值的说明。 1. 使用前请确认授权文件termb.lic在PC机C:\\根目录下。 2. 使用USB接口则请先安装对应系统的USB驱动；

3. termb.dll是主DLL，sdtapi.dll和WltRS.dll被termb.dll调用；用户可不必关

心sdtapi.dll和WltRS.dll，但三个DLL要求要放在同一个目录下；

4. termb.dll、sdtapi.dll和WltRS.dll同时拷贝到调用此Dll的应用软件Exe文件

所在目录下。

5. termb.dll 输出的文件放在调用者(*.exe)所在目录；

2 定义

应用函数开发包含在下列文件：

termb.dll API函数的动态联接库

（termb.dll的输出文件放在调用者所在目录中）

适用操作系统： Windows NT: 需要NT 3.1版或以后版本

Windows: 需要 Windows 98、Windows 2000或以后版本 适用开发语言：

Visual C++ 5.0 及以后版本 Visual Basic 5.0 及以后版本 DELPHI 3.0 及以后版本 PowerBuilder 6.0 及以后版本

3 函数列表

序号 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 函数定义 Int _stdcall InitComm(int Port) int _stdcall CloseComm() int _stdcall Authenticate() int _stdcall Read_Content(int Active) 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) 函数功能 初始化串口; 关闭串口; 卡认证; 读卡操作。 得到姓名信息 得到性别信息 得到民族信息 得到出生日期 得到地址信息 得到卡号信息 得到发证机关信息 地址：成都市高新西区国腾园3号楼3楼 邮编：611731 电话：（028）87825723 http：//www.szgoldtel.com.cn 传真：（028）87825734 E－mail：szgt@ guoteng.com.cn

第 4 页 共 16 页

第二代居民身份证阅读器GTICR-100函数包使用手册

12. 13. 14. 15. 16. int _stdcall GetStartDate(char *strTmp, int strLen) int _stdcall GetEndDate(char *strTmp, int strLen) int _stdcall GetReserve(char *strTmp, int strLen) int _stdcall SetBaseData(char *TxtFileName) int _stdcall SetPhotoData(char *WltFileName) 得到有效启始日期 得到有效截止日期 得到保留信息 设置基本信息 设置照片WLT信息 地址：成都市高新西区国腾园3号楼3楼 邮编：611731 电话：（028）87825723 http：//www.szgoldtel.com.cn 传真：（028）87825734 E－mail：szgt@ guoteng.com.cn

第 5 页 共 16 页

第二代居民身份证阅读器GTICR-100函数包使用手册

4 函数调用流程

读卡信息开始初始化串口读卡器认证

5 函数说明

5.1 初始化串口

原 型：int InitComm (int Port)

说 明：本函数用于计算机的串口初始化。 参 数：Port： 设置串口 值 1 2 3 4

返 回 值：

值 1 其它 示 例： #include

int main() { 地址：成都市高新西区国腾园3号楼3楼 邮编：611731 电话：（028）87825723 http：//www.szgoldtel.com.cn 传真：（028）87825734 E－mail：szgt@ guoteng.com.cn

第 6 页 共 16 页

关闭串口结束意义 串口1 串口2 串口3 串口4 注意：使用ICR-300系列产品进行二次开发时，固定为串口2。

意义 正确 错误 第二代居民身份证阅读器GTICR-100函数包使用手册

5.2 关闭串口

原 型： int CloseComm(void)

说 明：本函数用于关闭计算机已经打开的串口。 参 数：无 返 回 值：

值 1 其它 意义 正确 错误 int li_ret=0; int li_Port=1; li_ret=InitComm(li_Port); return li_ret; }

示 例： #include

int main() {

int li_ret=0; li_ret= CloseComm()

return li_ret; }

5.3 卡认证

原 型：int Authenticate (void)

说 明：本函数用于读卡器和卡片之间的合法身份确认。 参 数：无 返 回 值： 值 1 其它 意义 正确 错误 说明 卡片正确放置时 未放卡或卡片放置不正确时 注意：若卡片放置后发生认证错误时，应移走卡片重新放置。

示 例： #include

int main() { 地址：成都市高新西区国腾园3号楼3楼 邮编：611731 电话：（028）87825723 http：//www.szgoldtel.com.cn 传真：（028）87825734 E－mail：szgt@ guoteng.com.cn

第 7 页 共 16 页

第二代居民身份证阅读器GTICR-100函数包使用手册

int li_ret=0; li_ret= authenticate () return li_ret; }

注意：若采用查询方式自动判断卡片是否放置，则间隔时间建议大于300ms。

5.4读卡操作

原 型：int Read_Content(int Active)；

说 明：本函数用于通过读卡器从非接触卡中读取相应信息。 参 数：Active 读取信息类型 Active值 1 2 3 5 返 回 值：

值 1 0 -1 -2 -3 -4 -5 -6 意义 正确 读卡错误 相片解码错误 wlt文件后缀错误 wlt文件打开错误 wlt文件格式错误 软件未授权 设备连接失败 意义 读基本信息 只读文字信息 读最新住址信息 读芯片管理号 说明 形成文字信息文件WZ.TXT、相片文件XP.WLT和ZP.BMP 形成文字信息文件WZ.TXT和相片文件XP.WLT 形成最新住址文件NEWADD.TXT 形成二进制文件IINSNDN.bin

注意：

1、 读完基本信息后，若需要立即读取最新住址信息或芯片管理号，在未移走卡片的情况下可以不用卡认证；

2、 单独读取最新住址信息或芯片管理号时，需要先进行卡认证； 3、若卡片放置后发生读卡错误时，应移走卡片重新放置。

地址：成都市高新西区国腾园3号楼3楼 邮编：611731 电话：（028）87825723 http：//www.szgoldtel.com.cn 传真：（028）87825734 E－mail：szgt@ guoteng.com.cn

第 8 页 共 16 页

第二代居民身份证阅读器GTICR-100函数包使用手册

文字信息采用GB 13000的UCS-2进行存储，各项目分配如下： 项目 姓名 性别 民族 出生 住址 公民身份号码 签发机关 有效期起始日期 有效期截止日期 预留区 最新住址 芯片管理号分配如下： 项目 IIN SN DN 长度（字节） 4 8 16 说明 长度（字节） 30 2 4 16 70 36 30 16 16 36 70 说明 汉字 代码 代码 年月日：YYYYMMDD 汉字和数字 数字 汉字 年月日：YYYYMMDD 年月日：YYYYMMDD 有效期为长期时存储“长期” 保留信息 汉字和数字 5.5 用户信息函数组 该组函数用于读取当前系统缓冲中的二代证卡内信息。该组函数具有如下特点：

? 得到的字符信息全部为ANSI编码方式；可以直接用来显示；

? 得到的字符信息已经按照相关标准作了相应转换；将性别编码转换成了相应的文字

信息（如1-“男”），将民族编码转换成了相应的文字信息（如04-“藏”）； ? 该组函数返回值表示一致，含义如下：

0：表示取到的字符信息不完整，增大strTmp参数分配的内存，就可完整读出信息； （用户信息各字段的长度定义见下表） 非0：表示读出的字节总数；

用户信息各字段的长度定义 （单位：字节）

姓名 性别 民族 出生日期 住址 身份号码 签发机关 30 2 4 16 70 36 30 地址：成都市高新西区国腾园3号楼3楼 邮编：611731 电话：（028）87825723 http：//www.szgoldtel.com.cn 传真：（028）87825734 E－mail：szgt@ guoteng.com.cn

第 9 页 共 16 页

第二代居民身份证阅读器GTICR-100函数包使用手册

有效启始日期 有效截止日期 保留

16 16 36 A． 读取卡内姓名信息

原 型：int STDCALL GetPeopleName(char *strTmp, unsigned int strLen);

说 明：本函数用于读取ANSI字符编码方式的姓名信息； 参 数：[out] strTmp 读到的信息； [in] strLen 表示strTmp 参数分配的内存空间大小（单位：字节）；

B． 其他函数原型如下： 读性别信息：

int _stdcall GetPeopleSex(char *strTmp, unsigned int strLen); 读民族信息：

int _stdcall GetPeopleNation(char *strTmp, unsigned int strLen); 读出生日期：

int _stdcall GetPeopleBirthday(char *strTmp, unsigned int strLen); 读住址信息：

int _stdcall GetPeopleAddress(char *strTmp, unsigned int strLen); 读身份号码：

int _stdcall GetPeopleIDCode(char *strTmp, unsigned int strLen); 读签发机关：

int _stdcall GetDepartment(char *strTmp, unsigned int strLen); 读有效启始日期：

int _stdcall GetStartDate(char *strTmp, unsigned int strLen); 读有效截止日期：

int _stdcall GetEndDate(char *strTmp, unsigned int strLen); 读保留信息：

int _stdcall GetReserve(char *strTmp, unsigned int strLen);

读照片信息：

int _stdcall GetPhotoBMP(char *Photo, unsigned int Len);

5.6 数据解析函数

以下两个函数主要是用在无卡状态下解析保存在文件中的历史二代证信息；

? 将人员基本信息文件名（带全路径）通过SetBaseData函数送入termb.dll中后，

该Dll 将解析人员基本信息；外部程序可通过调用“读用户信息函数组”中的函数得到想要的信息；

? 将人员WLT类型的照片文件名（带全路径）通过SetPhoteData函数送入termb.dll

后，在二代证机具联机状态下（不需要卡），该dll将WLT文件解压成BMP文件，地址：成都市高新西区国腾园3号楼3楼 邮编：611731 电话：（028）87825723 http：//www.szgoldtel.com.cn 传真：（028）87825734 E－mail：szgt@ guoteng.com.cn

第 10 页 共 16 页

本文来源：https://www.bwwdw.com/article/f958.html