dll函数说明.txt

不管我的程序编得怎么样

以下所有函数中第一个参数为发送数据的串口号，除特别说明所有的函数返回为布尔值：TRUE代表函数执行成功，FALSE代表函数执行失败。
所有的金额如没有特别说明，都是以角为单位。

//总清数据(初始化)
_AllReset@8(int port,HWND h);
h为调用程序窗口的句柄。

//发行,设置卡余额
_FK@16(int port,char* kh,int ye,char *st);
kh为5位卡号的字符串
ye为该卡的初始余额
st为该卡的初始状态
st状态字节的含义
低4位保留
高4位含义：
最高位：1表示卡内余额为负值，0表示为正值
第二位：1为挂失卡，0为未挂失卡
第三位：1为已发行卡，0为未发行卡
第四位：1表示该流水信息是信用消费，0表示是正常消费

//卡加款
_AddMoney@12(int port,char* kh,int jke);
kh为5位卡号的字符串
jke为加款的金额，如果大于32767，则表示为扣款，扣款额为32768-jke
返回一个字符值：
"1":操作失败
"2":挂失卡
"3":未发行卡

//改卡状态(服务器内)
_SetST@12(int port,char* kh,char st);
st为要设置的状态字节，含义同前

//查询卡余额情况
_GetYe@16(int port,char* kh,int *ye,char *st);
kh为5位卡号的字符串
ye为查询返回的该卡金额
st为查询返回的该卡状态

//查分机售额
_GetFJSE@12(int port,char jh,DWORD *se);
jh为要查询的窗口机机号
se为查询返回的该机累计销售额

//清分机售额
_ClearFJSE@8(int port,char jh);
jh为要清除累计销售额的机号

//读服务器时间
_GetSvrTime@8(int port,char* sj);
sj为服务器返回的时间字符串，分别是两位年份，两位月份，两位日，两位时，两位分
其中年份为0-3，是最近一个闰年年份的值和该数字的和，比如今年为02，表示是上一个闰年2000年＋02，就是2002年。

//置服务器时间
_SetSvrTime@8(int port,char* sj);
sj为要设置的日期时间字符串，表示方法同上

//设定最大机号
_SetMaxJH@8(int port,unsigned char maxjh);
maxjh为要设置的服务器扫描最大窗口机机号

//读最大机号
_GetMaxJH@8(int port,unsigned char *maxjh);
maxjh为返回的服务器扫描最大窗口机机号

//设定扣款限额,超支限额,定额消费额
_Set3JE@20(int port,char jh,int xe,unsigned int tz,int de);
jh为要设置的窗口机机号
xe为该窗口机的一次消费最大金额，设为0表示没有限制，该值以元为单位
tz为该窗口机允许透支的最大金额
de为该窗口机每次刷卡自动扣除的金额，设为0表示取消自动扣款

//读扣款限额,超支限额,定额消费额
_Get3JE@20(int port,char jh,int *xe,unsigned int *tz,int *de);
jh为要读取的窗口机机号
xe、tz、de为该窗口机返回的三个相关参数

//读总记录(流水)数
_GetJLS@8(int port,int *jls);
jls为返回的服务器中流水条数

//清总记录数
_ClearJLS@4(int port);

//查流水
_GetLS@16(int port,char* fn,unsigned int *jls,HWND h);
fn为存储流水数据的文件名称字符串
jls为返回的流水条数
h为调用程序窗口的句柄
执行成功后，生成文件是一个二进制的文件，每12个字节为一条流水信息
格式如下：
1-2字节（ABCD）：卡号＝A*256+B
3字节：该帐户状态
4-5字节（AB）：余额＝A*256+B
6-7字节（AB）：消费额＝A*256+B，如果消费额大于32767，则消费额要减去32768，并加上负号，就是说消费额是负的。
8字节：消费时间的月份，BCD码
9字节：消费时间的日期，BCD码
10字节：消费时间的小时，BCD码
11字节：消费时间的分钟，BCD码
12字节：消费窗口机的机号

//汇总信用消费
_HZ@16(int port,unsigned char maxjh,char* st,HWND h);
maxjh是汇总的最大窗口机号
st是返回的各窗口机状态字符串，共maxjh个字节，每个字节表示对应机号的状态
第一个字节对应1号机，第二个字节对应2号机，依次类推
每个字节值对应含义：
"e"汇总错误
"o"服务器流水满
"0"窗口机无信用消费数据
h是调用程序窗口的句柄

//向分机送操作密码
_SetFJMM@8(int port,char* mm);
mm是要设置的4位密码字符串

//服务器向分机送所有卡挂失位
_SvrSendGF@8(int port,HWND h);
h是调用程序窗口的句柄

//单张卡即时挂失,解挂(同时送至服务器和所有分机)
_DKGF@12(int port,char* kh,char st);
kh是要挂失或解挂的卡号
st是表示挂失还是解挂：1表示挂失操作，0表示解挂操作

//设定快捷键菜单
_SetCJ@8(int port,int* cj);
cj为要设置的窗口机1-9号键的表示金额，一共是9个值

//实时记录
_RealTime@8(int port,unsigned char s);
s="P"进入实时监控状态，服务器会向PC串口发送每次消费的流水信息
S="C"退出实时监控状态
流水信息格式同上