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

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

二代证系统终端API 使用说明最新09/1/1

上海普天邮通商用机器有限公司

2009年1月

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

二代证系统终端API

使用说明

版 本 1.3

出版日期

2009年08月

著作权注意事项

本书版权为上海普天邮通商用机器有限公司所有。未经上海普天邮通商用机器有限公司书面同意，任何公司、单位或个人，不得用任何手段复制本手册的部分或全部内容。

对印刷错误的更正，所述信息谬误的勘误，以及产品的改进，均由上海普天邮通商用机器有限公司随时作出解释，恕不预先通知，修正内容将编入再版说明书中。

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

1. 前言

本应用程序接口(API)用于二代证验证系统的验证终端应用系统的开发。

2. 系统要求

? ? ? ?

使用本API的PC机，必须满足下列条件： Windows 2000, Windows XP

至少64兆内存（64M RAM or Larger）

至少10兆空闲硬盘空间（10M Free Hard Disk Space or Larger） 至少一个空闲普通串口或USB口（视用户需求而定）。

3. 文件列表

开发包含下列文件： cardapi.h 数据类型和函数声明

cardapi2.lib 静态链接库 cardapi2.dll API函数动态链接库 sdtapi.dll cardapi2.dll依赖的动态链接库 WltRS.dll cardapi2.dll依赖的动态链接库 license.dat 授权文件 CardII.ini 配置文件

4. 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)

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

读取二代证，所有参数中的字符串使用GBK编码。 参数

pInfo：证件信息结构，见4.6。

pszImageFile：照片路径和文件名。照片的格式是bmp。

例如 D:\\temp\\image.bmp。

返回值：错误代码。

4.4 long __stdcall ResetCardReader() 重置读卡器。

返回值：错误代码。

4.5 long __stdcall CloseCardReader() 关闭读卡器。

返回值：错误代码。

4.6 证件信息结构

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，例如20080808。有效截止日期可以是长期。

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

4.7 错误代码： 错误号 含义 0 成功 1 端口打开失败 2 数据传输超时 10 没有找到卡 11 读卡操作失败 20 自检失败 30 其他错误 40 相片解码失败 5. 注意事项

应用程序使用OpenCardReader打开设备，使用GetPersonMsgA读取信息，使用CloseCardReader关闭设备。应用程序只需要在初始化时打开一次设备即可，不需要每次读卡时都进行打开和关闭设备操作。程序停止读卡后应该调用CloseCardReader。

当出现严重错误时，应用程序可以调用OpenCardReade打开设备，使用ResetCardReader重置设备，该函数会等待2秒钟，然后调用CloseCardReader关闭设备。一般情况下不需要使用ResetCardReader。

需要使用UTF-16编码的可以调用GetPersonMsgW函数和PERSONINFOW数据结构进行读卡操作，代替GetPersonMsgA函数和PERSONINFOA数据结构，两者参数和结构体成员含义相同。

本文来源：https://www.bwwdw.com/article/oxuf.html