二代证Dll使用说明.doc

二代证系统终端API 使用说明必威体育精装版09/1/1 上海普天邮通商用机器有限公司 2009年1月 二代证系统终端API 使用说明 版　本 1.4 出版日期 2010年03月 著作权注意事项 　　本书版权为上海普天邮通商用机器有限公司所有。未经上海普天邮通商用机器有限公司书面同意，任何公司、单位或个人，不得用任何手段复制本手册的部分或全部内容。 对印刷错误的更正，所述信息谬误的勘误，以及产品的改进，均由上海普天邮通商用机器有限公司随时作出解释，恕不预先通知，修正内容将编入再版说明书中。 前言 本应用程序接口(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。建议不要使用相对路径或当前路径并且选择一个确定有读写权限的路径。 例如 C:\Documents and Settings\test\Local Settings\Temp\image.bmp（如果当前用户是test的话） 返回值：错误代码。 4.3 long __stdcall GetPersonMsgA(PPERSONINFOA pInfo, const char* pszImageFile) 读取二代证，所有参数中的字符串使用GBK编码。 参数 pInfo：证件信息结构，见4.6。 pszImageFile：照片路径和文件名。照片的格式是bmp。建议不要使用相对路径或当前路径并且选择一个确定有读写权限的路径。 例如 C:\Documents and Settings\test\Local Settings\Temp\image.bmp（如果当前用户是test的话） 返回值：错误代码。 4.4 long __stdcall ResetCardReader() 重置读卡器。 返回值：错误代码。 4.5 long __stdcall CloseCardReader() 关闭读卡器。 返回值：错误代码。 const wchar_t* __stdcall GetResultDescriptionW() 获取错误信息的文字描述。 返回值：错误信息，使用UTF-16编码。 证件信息结构 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 民族 bir