二代证系统终端API使用说明
二代证系统终端API使用说明最新11628
上海普天邮通商用机器有限公司
2011年6月
f二代证系统终端API使用说明
二代证系统终端API使用说明
版本21出版日期
2011年6月
著作权注意事项
本书版权为上海普天邮通商用机器有限公司所有。未经上海普天邮通商用机器有限公司书面同意，任何公司、单位或个人，不得用任何手段复制本手册的部分或全部内容。对印刷错误的更正，所述信息谬误的勘误，以及产品的改进，均由上海普天邮通商用机器有限公司随时作出解释，恕不预先通知，修正内容将编入再版说明书中。
f二代证系统终端API使用说明
一、前言
本应用程序接口API用于二代证验证系统的验证终端应用系统的开发。
二、系统要求
使用本API的PC机，必须满足下列条件：Wi
dows2000Wi
dowsXP或更高至少64兆内存（64MRAMorLarger）至少10兆空闲硬盘空间（10MFreeHardDiskSpaceorLarger）至少一个空闲普通串口或USB口（视用户需求而定）。

三、文件列表
API含下列文件：文件名说明cardapihcardapi3libcardapi3dllAPI中的各个函数在此DLL中实现sdtapidllWltRSdlllice
sedat授权文件使用API时请将cardapi3dll、sdtapidll、WltRSdll、lice
sedat四个文件放在一起。
四、API详细说明
1错误代码：错误号含义0成功1端口打开失败2数据传输超时10没有找到卡11读卡操作失败20自检失败30其他错误
f二代证系统终端API使用说明
40相片解码失败API中所有的函数都使用统一的错误代码。2证件信息结构typedefstruct_perso
i
fowwchar_t
ame16wchar_tsex2wchar_t
atio
10wchar_tbirthday10wchar_taddress36wchar_tcardId20wchar_tpolice16wchar_tvalidStart10wchar_tvalidE
d10wchar_tsexCode2wchar_t
atio
Code4wchar_tappe
dMsg36PERSONINFOWPPERSONINFOWtypedefstruct_perso
i
foachar
ame32charsex4char
atio
20charbirthday12charaddress72charcardId20charpolice32charvalidStart12charvalidE
d12charsexCode4char
atio
Code4charappe
dMsg72PERSONINFOAPPERSONINFOAPERSONINFOW中的字符串使用UTF16编码，PERSONINFOA中的字符串使用GBK编码。结构体成员说明：
ame姓名sex性别
atio
民族birthday出生日期address地址cardId身份证号码police签发机关
f二代证系统终端API使用说明
validStart有效开始日期validE
d有效截止日期sexCode性别代码
atio
Code民族代码appe
dMsg新地址其中日期格式均为YYYYMMDD，例如20080808。有效截止日期可以是长期。3lo
g__stdcallOpe
CardReaderlo
glPortULONGulFlagULONGulBaudRate打开并检测阅读器。参数r