二代证系统终端API使用说明
二代证系统终端API使用说明最新0911
上海普天邮通商用机器有限公司
2009年1月
f二代证系统终端API使用说明
二代证系统终端API使用说明
版本14出版日期
2010年03月
著作权注意事项
本书版权为上海普天邮通商用机器有限公司所有。未经上海普天邮通商用机器有限公司书面同意，任何公司、单位或个人，不得用任何手段复制本手册的部分或全部内容。对印刷错误的更正，所述信息谬误的勘误，以及产品的改进，均由上海普天邮通商用机器有限公司随时作出解释，恕不预先通知，修正内容将编入再版说明书中。
f二代证系统终端API使用说明
1前言
本应用程序接口API用于二代证验证系统的验证终端应用系统的开发。
2系统要求
使用本API的PC机，必须满足下列条件：Wi
dows2000Wi
dowsXP至少64兆内存（64MRAMorLarger）至少10兆空闲硬盘空间（10MFreeHardDiskSpaceorLarger）至少一个空闲普通串口或USB口（视用户需求而定）。
3文件列表
开发包含下列文件：cardapih数据类型和函数声明cardapi2lib静态链接库cardapi2dllAPI函数动态链接库sdtapidllcardapi2dll依赖的动态链接库WltRSdllcardapi2dll依赖的动态链接库lice
sedat授权文件CardIIi
i配置文件
4API详细说明
41lo
g__stdcallOpe
CardReaderlo
glPortULONGulFlag打开并检测读卡器参数lPort：端口号，116表示串口号，1001表示USB口，0表示自动选择。ulFlag：可选的标志位，可以用“或”运算符连接。
0x020x04允许重复读取证件。即证件不离开读卡器时可以多次读取。读卡时同时读取新地址。
返回值：错误代码。42lo
g__stdcallGetPerso
MsgWPPERSONINFOWpI
foco
stwchar_tpszImageFile读取二代证，所有参数中的字符串使用UTF16编码。参数pI
fo：证件信息结构，见46。pszImageFile：照片路径和文件名。照片的格式是bmp。建议不要使用相对路径或当前路径并且选择一个确定有读写权限的路径。例如CDocume
tsa
dSetti
gstestLocalSetti
gsTempimagebmp（如果当前用户是test的话）返回值：错误代码。
f二代证系统终端API使用说明
43lo
g__stdcallGetPerso
MsgAPPERSONINFOApI
foco
stcharpszImageFile读取二代证，所有参数中的字符串使用GBK编码。参数pI
fo：证件信息结构，见46。pszImageFile：照片路径和文件名。照片的格式是bmp。建议不要使用相对路径或当前路径并且选择一个确定有读写权限的路径。例如CDocume
tsa
dSetti
gstestLocalSetti
gsTempimagebmp（如果当前用户是test的话）返回值：错误代码。44lo
g__stdcallResetCardReader重置读卡器。返回值：错误代r