普天二代证系统终端API使用说明

《普天二代证系统终端API使用说明》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、二代证系统终端API使用说明二代证系统终端API使用说明最新09/1/1上海普天邮通商用机器有限公司2009年1月二代证系统终端API使用说明二代证系统终端API使用说明版　本1.3出版日期2009年08月著作权注意事项　　本书版权为上海普天邮通商用机器有限公司所有。未经上海普天邮通商用机器有限公司书面同意，任何公司、单位或个人，不得用任何手段复制本手册的部分或全部内容。对印刷错误的更正，所述信息谬误的勘误，以及产品的改进，均由上海普天邮通商用机器有限公司随时作出解释，恕不预先通知，修正内容将编入再版说明书中。二代证系统终端API使用说明前言本应用程序接口(API)用于二

2、代证验证系统的验证终端应用系统的开发。1.系统要求使用本API的PC机，必须满足下列条件：lWindows2000,WindowsXPl至少64兆内存（64MRAMorLarger）l至少10兆空闲硬盘空间（10MFreeHardDiskSpaceorLarger）l至少一个空闲普通串口或USB口（视用户需求而定）。2.文件列表开发包含下列文件：cardapi.h数据类型和函数声明cardapi2.lib静态链接库cardapi2.dllAPI函数动态链接库sdtapi.dllcardapi2.dll依赖的动态链接库WltRS.dllcardapi2.dll依赖的动态链接

3、库license.dat授权文件CardII.ini配置文件3.API详细说明4.1long__stdcallOpenCardReader(longlPort,ULONGulFlag)打开并检测读卡器参数lPort：端口号，1~16表示串口号，1001表示USB口，0表示自动选择。ulFlag：可选的标志位，可以用“或”运算符连接。0x02允许重复读取证件。即证件不离开读卡器时可以多次读取。0x04读卡时同时读取新地址。返回值：错误代码。4.2long__stdcallGetPersonMsgW(PPERSONINFOWpInfo,constwchar_t*pszImag

4、eFile)读取二代证，所有参数中的字符串使用UTF-16编码。参数pInfo：证件信息结构，见4.6。pszImageFile：照片路径和文件名。照片的格式是bmp。例如D:tempimage.bmp。返回值：错误代码。4.3long__stdcallGetPersonMsgA(PPERSONINFOApInfo,constchar*pszImageFile)二代证系统终端API使用说明读取二代证，所有参数中的字符串使用GBK编码。参数pInfo：证件信息结构，见4.6。pszImageFile：照片路径和文件名。照片的格式是bmp。例如D:tempimage.

5、bmp。返回值：错误代码。4.4long__stdcallResetCardReader()重置读卡器。返回值：错误代码。4.5long__stdcallCloseCardReader()关闭读卡器。返回值：错误代码。4.6证件信息结构PERSONINFOW结构的成员与PERSONINFOA类似。typedefstruct_personinfoa{charname[32];charsex[4];charnation[20];charbirthday[12];charaddress[72];charcardId[20];charpolice[32];charvalidSta

6、rt[12];charvalidEnd[12];charsexCode[4];charnationCode[4];charappendMsg[72];}PERSONINFOA,*PPERSONINFOA;结构体成员说明：name姓名sex性别nation民族birthday出生日期address地址cardId身份证号码police签发机关validStart有效开始日期validEnd有效截止日期appendMsg新地址其中日期格式均为YYYYMMDD，例如20080808。有效截止日期可以是长期。二代证系统终端API使用说明4.7错误代码：错误号含义0成功1端口打开失

7、败2数据传输超时10没有找到卡11读卡操作失败20自检失败30其他错误40相片解码失败1.注意事项应用程序使用OpenCardReader打开设备，使用GetPersonMsgA读取信息，使用CloseCardReader关闭设备。应用程序只需要在初始化时打开一次设备即可，不需要每次读卡时都进行打开和关闭设备操作。程序停止读卡后应该调用CloseCardReader。当出现严重错误时，应用程序可以调用OpenCardReade打开设备，使用ResetCardReader重置设备，该函数会等待2秒钟，然后调用CloseCardR