二代证Dll使用说明.doc

文档介绍：二代证Dll使用说明
二代证系统终端API使用说明
二代证系统终端API
使用说明最新11/6/28
上海普天邮通商用机器有限公司
2011年6月
二代证ndMsg[36];
}PERSONINFOW,*PPERSONINFOW;
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;
PERSONINFOW中的字符串使用UTF-16编码，PERSONINFOA中的字符串使用GBK编码。
结构体成员说明：
name
姓名
sex
性别
nation
民族
birthday
出生日期
address
地址
cardId
身份证号码
二代证系统终端API使用说明
police
签发机关
validStart
有效开始日期
validEnd
有效截止日期
sexCode
性别代码
nationCode
民族代码
appendMsg
新地址
其中日期格式均为YYYYMMDD，例如20080808。有效截止日期可以是长期。
long __stdcall OpenCardReader(long lPort, ULONG ulFlag, ULONG ulBaudRate)
打开并检测阅读器。
参数
lPort：端口号，1~16表示串口号，1001表示USB口，0表示自动选择。
ulFlag：可选的标志位，可以用“按位或”运算符组合。
Bit0
清零表示每次读卡时都重新打开和关闭端口。置1表示重复使用已打开的端口。建议使用蓝牙阅读器的用户将此位置1。
Bit1
允许重复读取证件。即证件不离开阅读器时可以被多次读取。
Bit2
读卡时同时读取新地址。
Bit16~Bit23
在接收到串口数据后等待的毫秒数(0~255)。
ulBaudRate：波特率。使用串口阅读器时请正确设置波特率。串口阅读器出厂时的波特率一般为115200。使用USB阅读器时忽略该参数。
返回值：错误代码。
long __stdcall GetPersonMsgW(PPERSONINFOW pInfo, const wchar_t* pszImageFile)
读取二代证，所有参数中的字符串使用UTF-16编码。
参数
pInfo：指向证件信息结构的指针。
pszImageFile：照片路径和文件名。照片的格式是bmp。
例如 C:\Documents and Settings\test\Local Settings\Temp\（如果当前用户是test的话）
二代证系统终端API使用说明
返回值：错误代码。
long __stdcall GetPersonMsgA(PPERSONINFOA pInfo, const char* pszImageFile)
读取二代证，所有参数中的字符串使用GBK编码。
参数
pInfo：指向证件信息结构的指针。
pszImageFile：照片路径和文件名。照片的格式是bmp。
例如 C:\Documents and Settings\test\Local Settings\Temp\（如果当前用户是test的话）
返回值：错误代码。
long __stdcall ResetCardReader()
重置阅读器。重置成功后自动等待2秒钟。一般情况下不使用该函数。
返回值：错误代码。
long __stdcall CloseCardReader()
关闭阅读器。
返回值：错误代码。
long __stdcall GetCardReaderStatus(long lPort, ULONG ulBaudRate)
获取阅读器的状态。应用程序调用此函数时不需要另外调用OpenCardReader和CloseCardReader函数。
参数
lPort：端口号，1~16表示串口号，1001表示USB口，0表示自动选择。
ul