二代证Dll使用说明.doc

文档介绍：二代证系统终端API使用说明最新09/1/。未经上海普天邮通商用机器有限公司书面同意,任何公司、单位或个人,不得用任何手段复制本手册的部分或全部内容。对印刷错误的更正,所述信息谬误的勘误,以及产品的改进,均由上海普天邮通商用机器有限公司随时作出解释,恕不预先通知,修正内容将编入再版说明书中。前言本应用程序接口(API)用于二代证验证系统的验证终端应用系统的开发。系统要求使用本API的PC机,必须满足下列条件:Windows2000,WindowsXP至少64兆内存(64MRAMorLarger)至少10兆空闲硬盘空间(10MFreeHardDiskSpaceorLarger)至少一个空闲普通串口或USB口(视用户需求而定)。文件列表开发包含下列文件: 授权文件 (longlPort,ULONGulFlag)打开并检测读卡器参数 lPort:端口号,1~16表示串口号,1001表示USB口,0表示自动选择。 ulFlag:可选的标志位,可以用“或”运算符连接。0x02允许重复读取证件。即证件不离开读卡器时可以多次读取。0x04读卡时同时读取新地址。返回值:错误代码。(PPERSONINFOWpInfo,constwchar_t*pszImageFile)读取二代证,所有参数中的字符串使用UTF-16编码。参数 pInfo:证件信息结构,。 pszImageFile:照片路径和文件名。照片的格式是bmp。建议不要使用相对路径或当前路径并且选择一个确定有读写权限的路径。例如C:\DocumentsandSettings\test\LocalSettings\Temp\(如果当前用户是test的话)返回值:错误代码。(PPERSONINFOApInfo,constchar*pszImageFile)读取二代证,所有参数中的字符串使用GBK编码。参数 pInfo:证件信息结构,。 pszImageFile:照片路径和文件名。照片的格式是bmp。建议不要使用相对路径或当前路径并且选择一个确定有读写权限的路径。例如C:\DocumentsandSettings\test\LocalSettings\Temp\(如果当前用户是test的话)返回值:错误代码。()重置读卡器。返回值:错误代码。()关闭读卡器。返回值:错误代码。constwchar_t*__stdcallGetResultDescriptionW()获取错误信息的文字描述。返回值:错误信息,使用UTF-16编码。证件信息结构PERSONINFOW结构的成员与PERSONINFOA类似。typedefstruct_personinfoa{ charname[32]; charsex[4]; charnation[20]; charbirthday[12]; charaddress[72]; charcardId[20]; charpolice[32]; charvalidStart[12]; charvalidEnd[12]; charsexCode[4]; charnationCode[4]; charappendMsg[72];}PERSONINFOA,*PPERSONINFOA;结构体成员说明:name姓名***别nation民族birthday出生日期address地址cardId身份证号码police签发机关validStart有效开始日期validEnd有效截止日期appendMsg新地址其中日期格式均为YYYYMMDD,例如20080808。有效截止日期可以是长期。:错误号含义0成功1端口打开失败2数据传输超时10没有找到卡11读卡操作失败20自检失败30其他错误40相片解码失败注意事项应用程序使用OpenCardReader打开设备,使用G