华视电子[1].身份证阅读器sdk使用手册

《华视电子[1].身份证阅读器sdk使用手册》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

身份证阅读器SDK使用手册身份证阅读器SDK使用手册V2.10华视电子读写设备有限公司2009年09月23日华视电子读写设备有限公司7之7 身份证阅读器SDK使用手册概述本手册是操作身份证阅读器动态库应用函数的定义格式、调用方法和返回值的说明。在使用前，请确认授权文件termb.lic是否在你的PC机C:根目录下。1.定义应用函数开发包含下列文件：termb.dllAPI函数的动态联接库sdtapi.dll内部动态库cvrapi.dll内部动态库wltrs.dll内部动态库termb.lic身份证相片解压授权文件，放于C:目录下适用操作系统：WindowsNT:需要NT3.1版或以后版本Windows:需要Windows98、Windows2000或以后版本适用开发语言：VisualC++5.0及以后版本VisualBasic5.0及以后版本Delphi3.0及以后版本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)得到身份证号信息华视电子读写设备有限公司7之7 身份证阅读器SDK使用手册intGetDepartment(char*strTmp,int*strLen)得到发证机关信息intGetStartDate(char*strTmp,int*strLen)得到有效开始日期intGetEndDate(char*strTmp,int*strLen)得到有效截止日期1.函数调用流程开始初始化连接打开射频关闭射频读卡操作CVR_Read_Content关闭连接结束卡认证读卡至内存缓存CVR_ReadBaseMsg2.函数说明初始化连接华视电子读写设备有限公司7之7 身份证阅读器SDK使用手册原型：intCVR_InitComm(intPort)说明：本函数用于PC与华视电子第二代居民身份证阅读器的连接。参数：Port：连接串口（COM1~COM16）或USB口(1001~1016)值意义1串口12串口23串口34串口41001USB口11002USB口21003USB口31004USB口4返回值：值意义1正确0错误关闭串口原型：intCVR_CloseComm(void)说明：本函数用于关闭PC到阅读器的连接。参数：无返回值：值意义1正确0错误卡认证原型：intCVR_Authenticate(void)说明：本函数用于读卡器和卡片之间的合法身份确认。卡认证循环间隔大于300ms。参数：返回值：值意义说明1正确卡片正确放置时0错误未放卡或卡片放置不正确时注意：若卡片放置后发生认证错误时，应移走卡片重新放置。读卡操作原型：intCVR_Read_Content(intActive)；说明：本函数用于通过阅读器从第二代居民身份证中读取相应信息。卡认证成功以后才可做读卡操作，读卡完毕若继续读卡应移走二代证卡片重新放置做卡认证。参数：Active读取信息类型Active意义说明华视电子读写设备有限公司7之7 身份证阅读器SDK使用手册1读基本信息生成文字WZ.TXT、相片数据XP.WLT和相片ZP.BMP(解码)2读基本信息生成文字WZ.TXT和相片数据XP.WLT3读最新住址信息生成最新住址NEWADD.TXT（卡无最新地址则生成空文件）4读基本信息生成WZ.TXT(解码)，相片ZP.BMP(解码)5读芯片管理号芯片管理号IINSNDN.bin6读基本信息以设备唯一标志号，生成文字WZ.TXT(解码)，相片XP.BMP(解码)（用于终端网络环境）返回值：返回值意义1正确0错误射频操作原型：intCVR_Ant(intmode)；说明：本函数用于打开/关闭射频。阅读器在不读卡时，如果射频对其它的电子产品有干扰的话，可以选择关闭射频，当需要读卡时，再打开射频。该函数只在当连接到串行接口的阅读器时，调用有效。如不调用此函数时，射频一直处于打开状态。注：当CVR_InitComm函数调用成功后，该函数有效。参数：modeMODE意义0关闭射频1打开射频返回值：返回值意义1正确0错误读文字、照片信息到自定义内存缓冲原型：intCVR_ReadBaseMsg(unsignedchar*pucCHMsg,unsignedint*puiCHMsgLen,unsignedchar*pucPHMsg,unsignedint*puiPHMsgLen,intnMode)说明：此函数代替CVR_Read_Content函数，将身份信息读到自定义内存缓冲中。卡认证CVR_Authenticate成功以后调用本函数。参数：参数说明备注pucCHMsg身份文字信息内存缓冲指针方向：OutpuiCHMsgLen身份文字信息长度默认256BytepucPHMsg身份照片信息内存缓冲指针方向：Out华视电子读写设备有限公司7之7 身份证阅读器SDK使用手册puiPHMsgLen身份照片信息长度默认1024BytenMode传入参数1文字编码为默认UCS-2格式，照片未解压成bmp文件传入参数2文字编码已转换成GBK国标码格式，照片未解压成bmp文件传入参数3文字编码为默认UCS-2格式，照片已解压成zp.bmp文件传入参数4文字编码已转换成GBK国标码格式，照片已解压成zp.bmp文件返回值：返回值意义1正确0错误读各项文字信息到自定义内存缓冲原型：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返回的信息长度指针。返回值：返回值意义1正确0错误注意：若采用查询方式自动判断卡片是否放置，则间隔时间建议大于300ms。华视电子读写设备有限公司7之7 身份证阅读器SDK使用手册注意：1、读完基本信息后，若需要立即读取最新住址信息或芯片管理号，在未移走卡片的情况下可以不用卡认证；2、单独读取最新住址信息或芯片管理号时，需要先进行卡认证；3、若卡片放置后发生读卡错误时，应移走卡片重新放置。文字信息采用GB13000的UCS-2进行存储，各项目分配如下：项目长度（字节）说明姓名30汉字性别2代码民族4代码出生16年月日：YYYYMMDD住址70汉字和数字公民身份号码36数字签发机关30汉字有效期起始日期16年月日：YYYYMMDD有效期截止日期16年月日：YYYYMMDD有效期为长期时存储“长期”最新住址70汉字和数字芯片管理号分配如下：项目长度（字节）说明IIN4SN8DN16华视电子读写设备有限公司7之7