readme.txt

该文件可以用VC++6.0打开编译实现加密解密功能

函数说明格式：　1)、函数原型
                2)、函数用途及说明
            	3)、函数参数说明
            	4)、函数适用机型
            	5)、函数备注(个别函数)


1、下载函数：

	1)、bool GetFirst(int Port,int MachNo)

        2)、用途及说明：跟机器进行连接沟通，成功返回true,失败则返回false; 

	3)、参数：Port: 表示串号号码，1为端口1,2为端口2，以此类推
                  MachNo: 机器编号，表示所要下载的机器编号

	
	   备注：相关函数GetNextK或GetNext

	按照用途的不同分成考勤的GetNextK函数和消费的GetNext函数：

	考勤：

        1)、bool GetNextK(int MachNo,char *Result)
	
	2)、用途及说明：返回机器内下一条记录，返回值为一个22位的字符串，如采集完毕，
            则返回"OVER"，成功返回true,失败返回false;
        
	3)、参数：MachNo: 机器编号，表示所要下载的机器编号
	          Result:一个长度为22的字符数据组，返回结果存在此数据组中



		字符串格式为：	2002080810280000002002
		前8位  20020808：  表示日期为2002年8月8日;
		下4位  1028：      表示时间10:28;
		下1位  0：         表示标识位(0表示正常刷卡，1表示用户按了外出标识，2表示用户按
				   了外入标识);
		下6位  00002：     表示卡号;
    		后3位  002：       表示考勤机机号。


	
	调用实例：

      	以上两个函数必须合在一起使用，先用GetFirst取得机内第一条记录，如果返回值不是
	"OVER"或NULL，则用GetNextK或GetNext继续读取机器下一条记录，直到返回"OVER"为止;  
       
        C++ 例程:
            char s_Result[36] = {0};
            if (GetFirst(1,1))
	    {
	        while (GetNext(1,s_Result))
		{
		    if ((AnsiString)s_Result != "OVER" && (AnsiString)s_Result != NULL)
		    	ListBox1->Items->Add(s_Result);
                    else
			break;
        	}
	    }
            if (s_Result == "OVER")
		MessageBox(0,"下载完成!","系统信息",MB_OK + MB_ICONINFORMATION);
	    else if (s_Result == "")
		MessageBox(0,"下载失败!请检查连线是否正确!","系统信息",MB_OK + MB_ICONERROR);


2、取机内数据总数

	1)、int GetRecordCount(int Port,int MachNo)

        2)、用途及说明：取得机器内已存储数据总量,成功返回机内数据，失败返回-1

	3)、参数：Port: 表示串号号码，1为端口1,2为端口2，以此类推
            	  MachNo: 机器编号，表示所要操作的机器编号




3、设置机器时间
	
	1)、bool SetTime(int Port,int MachNo)
	
	2)、用途及说明：以当前计算机时间设置机器时间，成功返回true,失败返回false;

	3)、参数：Port: 表示串号号码，1为端口1,2为端口2，以此类推
            	  MachNo: 机器编号，表示所要操作的机器编号



4、取机器时间

	1)、bool GetTime(int Port,int MachNo,char *Result)
	
	2)、用途及说明：取得机器当前时间，返回一个14位字符，格式为yyyymmddhhrrss，成功返回true,
		        失败返回false
	
	3)、参数：Port: 表示串号号码，1为端口1,2为端口2，以此类推
            	  MachNo: 机器编号，表示所要操作的机器编号
		  Result: 一个长度为14的字符串数组，取回的机器时间存在此数组


		
5、清除机内数据

	1)、bool Clear(int Port,int MachNo)
	
	2)、用途及说明：清除机器内所有数据并不可恢复，成功返回true,失败返回false;

	3)、参数：Port: 表示串号号码，1为端口1,2为端口2，以此类推
	    	  MachNo: 机器编号，表示所要操作的机器编号



6、设置管理卡
	
	1)、bool SetMasterCard(int Port,char *CardNo)

	2)、用途及说明：设置机器的管理卡，成功返回true，失败返回false

	3)、参数：Port：表示串号号码，1为端口中，2为端口2，以此类推	
	    	  CardNo：一个长度为6位的卡号，此卡将作为机器管理卡
	
	4)、备注：此时网络上只允许一台机器跟计算机相连



7、设置机器号码

	1)、bool SetMachNo(int Port,char *MachNo)

	2)、用途及说明：设置当前连接的机器的机器编号，成功返回true，失败返回false

	3)、参数：Port：表示串号号码，1为端口中，2为端口2，以此类推	
	    	  MachNo: 一个长度为4的字符串，表示要更改成的机器编号

			 当机器是考勤机时：结尾以"K"或非"K"将机器改成考勤或门禁机状态，如001K表
			 示001号考勤机器，而0521则表示005号门禁机；

                         当机器是消费机时：结尾无任何意义，0010表示1号终端。
	



8、设置考勤打卡间隔或门禁开锁时间

	1)、bool SetIntervalTime(int Port,int MachNo,int Time)

	2)、用途及说明：

		考勤机：设置同一张卡在多少秒之间不允许重复刷卡，单位为秒；

		门禁机：设置开门锁的延时时间，单位为1/10秒，如50表示开门5秒钟
	
	3)、参数：Port：表示串号号码，1为端口中，2为端口2，以此类推	
	    	  MachNo：一个长度为4的字符串，表示要更改成的机器编号
		  Time：值为0~255之间的数值，表示间隔或开门的时间


9、 挂失卡号或开户卡号

	1)、bool SetOpenCard(int Port,int MachNo,char *CardInfo)

	2)、用途及说明：

		门禁机：为卡片在机器上开户，只有开户的机器才能开门，否则报警

	3)、参数：Port：表示串号号码，1为端口中，2为端口2，以此类推	
	    	  MachNo: 机器编号，表示所要操作的机器编号
		  CardInfo：
			门禁机：一个长度为12位的字符串，前6位表示卡号，后6位表示开门密码，如果后
				6位全部为0则不需密码开门，如123456000000。

	   备注：在门禁机上为开户功能(并且同门禁机的开门时段有关，见函数SetOpenTime)

10、解挂卡号或取消已开户卡号帐号
	
	1)、bool DelOpenCard(int Port,int MachNo,char *CardNo)
	
	2)、用途及说明：

		门禁机：取消已开户卡号的帐号，成功返回true，失败返回false；

	3)、参数：Port：表示串号号码，1为端口中，2为端口2，以此类推	
	    	  MachNo: 机器编号，表示所要操作的机器编号
		  CardNo：一个长度为6位的字符串卡号，表示要操作的卡号
	

	5)、备注：在门禁机上为删除帐号功能。

11、解挂所有卡号或删除所有已开户卡号

	1)、bool ClearOpenCard(int Port,int MachNo)

	2)、用途及说明：

	    	门禁机：删除所有已开户的帐号资料，成功返回true，失败返回false；

	3)、参数：Port：表示串号号码，1为端口中，2为端口2，以此类推	
	    	  MachNo: 机器编号，表示所要操作的机器编号
	      
          备注：在门禁机上删除所有的已开户卡号帐号。


17、设置开门时段

	1)、bool SetOpenTime(int Port,int MachNo,char *Params)

	2)、用途及说明：设置普通门禁卡可开门的时间范围，成功返回true，失败返回false

	3)、参数：Port：表示串号号码，1为端口1，2为端口2，以此类推
	    	  MachNo: 机器编号，表示所要操作的机器编号
	          Params: 一个长度为9的字符串，如"108001200"表示序号为1的打卡范围，
		          起始时间为08:00，终止时间为1200，共10个打铃时间，序号为0~9
	

	5)、备注：相关函数SetOpenCard

18、设置打铃时间

	1)、bool SetBellTime(int Port,int MachNo,char *Params)

	2)、用途及说明：设置机器到时打铃的时间，成功返回true，失败返回false

	3)、参数：Port：表示串号号码，1为端口1，2为端口2，以此类推
	    	  MachNo: 机器编号，表示所要操作的机器编号
	          Params: 一个长度为8的字符串，如"01130100"表示序号为0的打铃，
                          时间为11:30，响铃时长110秒，共10个打铃时间，序号为0~9