身份证阅读器动态库应用函数的定义格式调用方法和返回值的说明Word格式文档下载.docx

身份证阅读器动态库应用函数的定义格式调用方法和返回值的说明Word格式文档下载.docx

《身份证阅读器动态库应用函数的定义格式调用方法和返回值的说明Word格式文档下载.docx》由会员分享，可在线阅读，更多相关《身份证阅读器动态库应用函数的定义格式调用方法和返回值的说明Word格式文档下载.docx（9页珍藏版）》请在冰豆网上搜索。

PowerBuilder6.0及以后版本

2.函数列表

//以下为主要API函数

intCVR_InitComm（intPort）初始化连接;

intCVR_Authenticate（）卡认证;

intCVR_Read_Content（intActive）读卡操作。

intCVR_CloseComm（）关闭连接;

//以下为可选API函数,方便二次开发

intCVR_Ant（intmode）射频操作

intCVR_ReadBaseMsg（

unsignedchar*pucCHMsg,unsignedint*puiCHMsgLen,unsignedchar*pucPHMsg,unsignedint*puiPHMsgLen,

intnMode）读卡操作（读入内存）

intGetPeopleName（char*strTmp,int*strLen）得到姓名信息

intGetPeopleSex（char*strTmp,int*strLen）得到性别信息

intGetPeopleNation（char*strTmp,int*strLen）得到民族信息

intGetPeopleBirthday（char*strTmp,int*strLen）得到出生日期

intGetPeopleAddress（char*strTmp,int*strLen）得到地址信息

intGetPeopleIDCode（char*strTmp,int*strLen）得到身份证号信息

intGetDepartment（char*strTmp,int*strLen）得到发证机关信息

intGetStartDate（char*strTmp,int*strLen）得到有效开始日期

intGetEndDate（char*strTmp,int*strLen）得到有效截止日期

3.函数调用流程

. 

函数说明

4.1 

初

始化连接

原型：

intCVR_InitComm（intPort）

说明：

本函数用于PC与华视电子第二代居民身份证阅读器的连接。

参数：

Port：

连接串口（COM1~COM16）或USB口（1001~1016）

值

意义

1

串口1

2

串口2

3

串口3

4

串口4

1001

USB口1

1002

USB口2

1003

USB口3

1004

USB口4

返回值：

正确

错误

4.2 

关闭串口

intCVR_CloseComm（void）

本函数用于关闭PC到阅读器的连接。

无

4.3 

卡认证

intCVR_Authenticate（void）

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

卡认证循环间隔大于300ms。

说明

卡片正确放置时

未放卡或卡片放置不正确时

注意：

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

4.4 

读卡操作

intCVR_Read_Content（intActive）；

本函数用于通过阅读器从第二代居民身份证中读取相应信息。

卡认证成功以后才可做读卡操作，读卡完毕若继续读卡应移走二代证卡片重新放置做卡认证。

Active读取信息类型

Active

读基本信息

生成文字WZ.TXT、相片数据XP.WLT和相片ZP.BMP（解码）

生成文字WZ.TXT和相片数据XP.WLT

读最新住址信息

生成最新住址NEWADD.TXT（卡无最新地址则生成空文件）

生成WZ.TXT（解码），相片ZP.BMP（解码）

5

读芯片管理号

芯片管理号IINSNDN.bin

6

以设备唯一标志号，生成文字WZ.TXT（解码），相片XP.BMP（解码）

（用于终端网络环境）

返回值

4.5 

射频操作

intCVR_Ant（intmode）；

本函数用于打开/关闭射频。

阅读器在不读卡时，如果射频对其它的电子产品有干扰的话，可以选择关闭射频，当需要读卡时，再打开射频。

该函数只在当连接到串行接口的阅读器时，调用有效。

如不调用此函数时，射频一直处于打开状态。

注：

当CVR_InitComm函数调用成功后，该函数有效。

mode

MODE

关闭射频

打开射频

4.6 

读文字、照片信息到自定义内存缓冲

原型：

intCVR_ReadBaseMsg（unsignedchar*pucCHMsg,unsignedint*puiCHMsgLen,unsignedchar*pucPHMsg,unsignedint*puiPHMsgLen,

intnMode）

说明：

此函数代替CVR_Read_Content函数，将身份信息读到自定义内存缓冲中。

卡认证CVR_Authenticate成功以后调用本函数。

参数：

参数

说明

备注

pucCHMsg

身份文字信息内存缓冲指针

方向：

Out

puiCHMsgLen

身份文字信息长度

默认256Byte

pucPHMsg

身份照片信息内存缓冲指针

puiPHMsgLen

身份照片信息长度

默认1024Byte

nMode

传入参数1

文字编码为默认UCS-2格式，

照片未解压成bmp文件

传入参数2

文字编码已转换成GBK国标码格式，

传入参数3

照片已解压成zp.bmp文件

传入参数4

4.7 

读各项文字信息到自定义内存缓冲

int_stdcallGetPeopleName（char*strTmp,int*strLen）//得到姓名信息

int_stdcallGetPeopleSex（char*strTmp,int*strLen）//得到性别信息

int_stdcallGetPeopleNation（char*strTmp,int*strLen）//得到民族信息

int_stdcallGetPeopleBirthday（char*strTmp,int*strLen）//得到出生日期

int_stdcallGetPeopleAddress（char*strTmp,int*strLen）//得到地址信息

int_stdcallGetPeopleIDCode（char*strTmp,int*strLen）//得到卡号信息

int_stdcallGetDepartment（char*strTmp,int*strLen）//得到发证机关信息

int_stdcallGetStartDate（char*strTmp,int*strLen）//得到有效开始日期

int_stdcallGetEndDate（char*strTmp,int*strLen）//得到有效截止日期

以上函数调用流程为：

调用CVR_Read_Content或者CVR_ReadBaseMsg函数成功后再分别调用以上函数。

CVR_Read_Content或者CVR_ReadBaseMsg函数自动在应用程序当前目录产生BMP照片文件。

参数：

*strTmp返回的信息缓存指针。

*strLen返回的信息长度指针。

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

1、 

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

2、 

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

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

文字信息采用GB13000的UCS-2进行存储，各项目分配如下：

项目

长度（字节）

姓名

30

汉字

性别

代码

民族

出生

16

年月日：

YYYYMMDD

住址

70

汉字和数字

公民身份号码

36

数字

签发机关

有效期起始日期

有效期截止日期

有效期为长期时存储“长期”

最新住址

芯片管理号分配如下：

IIN

SN

8

DN

functionCVR_InitComm（constPort:

integer）:

integer;

stdcall;

external'

termb.dll'

;

functionCVR_Authenticate（）:

functionCVR_Read_Content（constActive:

functionCVR_CloseComm（）:

functionCVR_Ant（constmode:

functionCVR_ReadBaseMsg（constpucCHMsg:

pchar;

constpuiCHMsgLen:

Longint;

constnMode:

functionGetPeopleName（conststrTmp:

pchar;

conststrLen:

functionGetPeopleSex（conststrTmp:

functionGetPeopleNation（conststrTmp:

functionGetPeopleBirthday（conststrTmp:

functionGetPeopleAddress（conststrTmp:

functionGetPeopleIDCode（conststrTmp:

functionGetDepartment（conststrTmp:

functionGetStartDate（conststrTmp:

functionGetEndDate（conststrTmp: