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

二代证系统终端API 使用说明最新09/1/1 上海普天邮通商用机器有限公司 2009年1月 二代证系统终端API 使用说明 版　本 1.3 出版日期 2009年08月 著作权注意事项 　　本书版权为上海普天邮通商用机器有限公司所有。未经上海普天邮通商用机器有限公司书面同意，任何公司、单位或个人，不得用任何手段复制本手册的部分或全部内容。 对印刷错误的更正，所述信息谬误的勘误，以及产品的改进，均由上海普天邮通商用机器有限公司随时作出解释，恕不预先通知，修正内容将编入再版说明书中。 前言 本应用程序接口(API)用于二代证验证系统的验证终端应用系统的开发。 系统要求 使用本API的PC机，必须满足下列条件： Windows 2000, Windows XP 至少64兆内存（64M RAM or Larger） 至少10兆空闲硬盘空间（10M Free Hard Disk Space or Larger） 至少一个空闲普通串口或USB口（视用户需求而定）。 文件列表 开发包含下列文件： cardapi.h 数据类型和函数声明 cardapi2.lib 静态链接库 cardapi2.dll API函数动态链接库 sdtapi.dll cardapi2.dll依赖的动态链接库 WltRS.dll cardapi2.dll依赖的动态链接库 license.dat 授权文件 CardII.ini 配置文件 API详细说明 4.1 long __stdcall OpenCardReader(long lPort, ULONG ulFlag) 打开并检测读卡器 参数 lPort：端口号，1~16表示串口号，1001表示USB口，0表示自动选择。 ulFlag：可选的标志位，可以用“或”运算符连接。 0x02 允许重复读取证件。即证件不离开读卡器时可以多次读取。 0x04 读卡时同时读取新地址。 返回值：错误代码。 4.2 long __stdcall GetPersonMsgW(PPERSONINFOW pInfo, const wchar_t* pszImageFile) 读取二代证，所有参数中的字符串使用UTF-16编码。 参数 pInfo：证件信息结构，见4.6。 pszImageFile：照片路径和文件名。照片的格式是bmp。 例如 D:\temp\image.bmp。 返回值：错误代码。 4.3 long __stdcall GetPersonMsgA(PPERSONINFOA pInfo, const char* pszImageFile) 读取二代证，所有参数中的字符串使用GBK编码。 参数 pInfo：证件信息结构，见4.6。 pszImageFile：照片路径和文件名。照片的格式是bmp。 例如 D:\temp\image.bmp。 返回值：错误代码。 4.4 long __stdcall ResetCardReader() 重置读卡器。 返回值：错误代码。 4.5 long __stdcall CloseCardReader() 关闭读卡器。 返回值：错误代码。 证件信息结构 PERSONINFOW结构的成员与PERSONINFOA类似。 typedef struct _personinfoa { char name[32]; char sex[4]; char nation[20]; char birthday[12]; char address[72]; char cardId[20]; char police[32]; char validStart[12]; char validEnd[12]; char sexCode[4]; char nationCode[4]; char appendMsg[72]; }PERSONINFOA,*PPERSONINFOA; 结构体成员说明： name 姓名 sex 性别 nation 民族 birthday 出生日期 address 地址 cardId 身份证号码 police 签发机关 validStart 有效开始日期 validEnd 有效截止日期 appendMsg 新地址 其中日期格式均为YYYYMMDD，例有效截止日期可以是长期。 4.7 错误代码： 错误号 含义 0 成功 1 端口打开失败 2 数据传输超时 10 没有找到卡 11 读卡操作失败 20 自检失败 30 其他错误 40 相片解码失败 注意事项 应用程序使用OpenCardReader打开设备，使用GetPersonMsgA读取信息，使用CloseCardRead