国腾身份证阅读器GTICR100-01 termb.dll应用开发使用手册

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

函数包使用手册

成都国腾

2005.4

文档控制

文档更新记录

地址：成都市高新西区国腾园3号楼3楼邮编：611731

目录

1概述 (4)

2定义 (4)

3函数列表 (4)

4函数调用流程 (6)

5函数说明 (6)

6用户信息函数组使用时的调用顺序说明 (12)

7一个完整的示例： (13)

地址：成都市高新西区国腾园3号楼3楼邮编：611731

1概述

本手册是操作身份证阅读器应用函数的定义格式、调用方法和返回值的说明。

1.使用USB接口则请先安装对应系统的USB驱动；

2.termb.dll是主DLL， WltRS.dll被termb.dll调用；用户可不必关心WltRS.dll，

但2个DLL要求要放在同一个目录下；

3.termb.dll和WltRS.dll同时拷贝到调用此Dll的应用软件Exe文件所在目录下。

4.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函数列表

地址：成都市高新西区国腾园3号楼3楼邮编：611731

地址：成都市高新西区国腾园3号楼3楼邮编：611731

4函数调用流程

5函数说明

5.1 初始化串口

原型：int InitComm (int Port)

说明：本函数用于计算机的设备初始化。

参数：Port：

返回值：

地址：成都市高新西区国腾园3号楼3楼邮编：611731

示例：

#include

int main()

{

int li_ret=0;

int li_Port=1;

li_ret=InitComm(li_Port);

return li_ret;

}

5.2 关闭串口

原型：

int CloseComm(void)

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

参数：无

返回值：

示例：

#include

int main()

{

int li_ret=0;

li_ret= CloseComm()

return li_ret;

}

5.3 卡认证

原型：int Authenticate (void)

说明：本函数用于读卡器和卡片之间的合法身份确认。

参数：无

返回值：

地址：成都市高新西区国腾园3号楼3楼邮编：611731

注意：若卡片放置后发生认证错误时，应移走卡片重新放置。

示例：

#include

int main()

{

int li_ret=0;

li_ret= authenticate ()

return li_ret;

}

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

5.4读卡操作

原型：int Read_Content(int Active)；

说明：本函数用于通过读卡器从非接触卡中读取相应信息。

参数：Active 读取信息类型

返回值：

注意：

1、读完基本信息后，若需要立即读取最新住址信息或芯片管理号，在未移走卡

片的情况下可以不用卡认证；

2、单独读取最新住址信息或芯片管理号时，需要先进行卡认证；

3、若卡片放置后发生读卡错误时，应移走卡片重新放置。

地址：成都市高新西区国腾园3号楼3楼邮编：611731

地址：成都市高新西区国腾园3号楼3楼邮编：611731

5.5 用户信息函数组

该组函数用于读取当前系统缓冲中的二代证卡内信息。该组函数具有如下特点：

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

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

信息（如1-“男”），将民族编码转换成了相应的文字信息（如04-“藏”）；

●该组函数返回值表示一致，含义如下：

0：表示取到的字符信息不完整，增大strTmp参数分配的内存，就可完整读出信息；

（用户信息各字段的长度定义见下表）

非0：表示读出的字节总数；

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

地址：成都市高新西区国腾园3号楼3楼邮编：611731

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