普天二代身份证读卡器SDK调用流程注意事项和错误代码

刷卡器型号：普天CPIDMR02/TG身份证阅读器

SDK版本：20200924

调用流程：

1.手动读卡
（1）程序启动时调用IdcrInitialize初始化开发包。
（2）用户执行读卡操作。
（3）调用IdcrOpen打开端口。
（4）调用IdcrValidate验卡。或者分别调用IdcrFindCard寻卡、IdcrSelectCard选卡和IdcrReadCard读卡来完成验卡步骤。
（5）根据证件类型调用IdcrGetIDInfoW / IdcrGetIDInfoA获取身份证信息，调用IdcrGetPRInfoW/ IdcrGetPRInfoA获取外国人永久居留证信息，或调用IdcrGetHMTInfoW/IdcrGetHMTInfoA获取港澳台居民居住证信息。
（6）调用IdcrClose关闭端口。
（7）第（2）步到第（6）步可多次执行。
（8）程序退出时调用IdcrFinalize释放开发包。

2.自动读卡
（1）程序启动时调用IdcrInitialize初始化开发包。
（2）程序睡眠半秒钟。
（3）如果未打开端口，调用IdcrOpen打开端口。
（4）调用IdcrFindCard寻卡。如果出错（出现错误码1先调用IdcrClose关闭端口）返回第（2）步。
（5）调用IdcrSelectCard选卡。如果出错返回第（2）步。
（6）调用IdcrReadCard读卡。如果出错返回第（2）步。
（7）根据证件类型调用IdcrGetIDInfoW / IdcrGetIDInfoA获取身份证信息，调用IdcrGetPRInfoW/ IdcrGetPRInfoA获取外国人永久居留证信息，或调用IdcrGetHMTInfoW/IdcrGetHMTInfoA获取港澳台居民居住证信息。
（8）要继续读卡的返回第（2）步。
（9）调用IdcrClose关闭端口。
程序退出时调用IdcrFinalize释放开发包。

注意事项：

1.使用示例时请将cardapi7.dll、sdtapi.dll、WltRS.dll、license.dat四个文件放在同一个路径中。该路径可以与应用程序所在的路径不同。
2.安装程序在运行的过程中应该将license.dat复制到C盘根目录。
3.如果调用IdcrInitialize后返回0x118，即“创建授权文件失败”，请手动将license.dat复制到C盘根目录。
4.由于64位的相片解码库目前还不稳定。本开发包目前只提供32位版本。开发.net应用程序时必须将“目标平台”设置为“x86”。开发Java应用程序时必须使用32位JDK和JRE。

错误代码：

错误码	描述
0x00	操作成功
0x01	打开端口失败
0x02	PC接收数据超时
0x03	PC判断校验和错
0x05	SAM串口不可用
0x10	SAM判断校验和错
0x11	SAM接收数据超时
0x21	接收业务终端的命令错误
0x23	越权操作
0x24	无法识别的错误
0x31	卡认证机具失败
0x32	机具认证卡失败
0x33	信息验证错误
0x34	尚未找卡，不能进行对卡的操作
0x37	指纹信息验证错误
0x3F	信息长度错误
0x40	无法识别的卡类型
0x41	读卡操作失败
0x47	取随机数失败
0x60	自检失败，不能接收命令
0x66	SAM没经过授权,无法使用
0x80	寻卡失败
0x81	选卡失败
0x90	操作成功
0x91	卡中无此项内容
0x9F	寻卡成功
0x100	调用sdtapi.dll错误
0x101	相片解码错误
0x102	wlt文件后缀错误
0x103	wlt文件打开错误
0x104	wlt文件格式错误
0x105	软件未授权
0x106	设备连接错误
0x107	相片解码其它错误
0x110	已经初始化过了
0x111	未初始化
0x112	未打开端口
0x113	参数错误
0x114	缓冲区太小
0x115	分配内存失败
0x116	读写文件失败
0x117	加载DLL失败
0x118	创建授权文件失败
0x119	应答头错误
0x11A	应答长度错误
0x11B	寻卡应答错误
0x11C	信息长度错误