commplus.h

HT系列掌机部分功能测试程序（含源码）

   17 
  */

  extern unsigned char GetAuxNinthBit(void);
  /*
   18 
     【注释】  此函数在HT-2800上无效。
  */

  extern void PutAuxNinthBit(unsigned char NinthBit);
  /*
   19 
     【注释】  此函数在HT-2800上无效。
  */

  extern void DisableTimeOut(void);
  /*
   20 文件通信过程中关闭超时检测开关。
  　  参数：
	       无
      返回参数:
	       无
      函数值：
	       无
     【注释】当打开超时检测开关时, 一旦数据包超过其最大可能传输延误二十秒后
             仍未到达，文件通信自动中断并返回超时错误。
   　　　　　在文件通信过程中如无必需的长时间延误，建议打开超时检测开关以避
 　  　　　　免因链路故障导致的死等。
  */ 

  extern void EnableTimeOut(void);
  /*
   21 文件通信过程中打开超时检测开关。
  　  参数：     
               无
      返回参数: 
               无
      函数值：
	       无
     【注释】当打开超时检测开关时, 一旦数据包超过其最大可能传输延误二十秒后
             仍未到达，文件通信自动中断并返回超时错误。
   　　　　　在文件通信过程中如无必需的长时间延误，建议打开超时检测开关以避
  　 　　　　免因链路故障导致的死等。
  */ 

  extern int  ExfOpen(unsigned char OpenMode, unsigned int ValidSNo,
                      char far *FileName,
                      unsigned char far *ExfAttr,
                      unsigned long far *ExfSize,
                      unsigned long far *ExfStamp,
                      unsigned int far *theOthSNo);
  /*
   22 数据包通信方式下按读/写请求打开外部文件。
  　  参数：　
               OpenMode      打开方式
                             _READ  读外部文件
                             _WRITE 写外部文件
               ValidSNo      对方允许系列号
               FileName      文件名字符串
               ExfAttr       文件属性
               ExfSize       文件大小
               ExfStamp      文件时间(按MS-DOS文件时间格式存放)
               theOthSNo     对方实际系列号
     【注释】依读请求打开外部文件时
 　　　　　 　  输入参数为：
 　　　　　　   对方允许系列号　用来指定通信对方所必须具有的机器系列号，
 　　　　　　　　　　　　　　　 为零时表示可以与任意机器通信。
 　　　　　　　 文件名字符串    以字符*开始的字符串表明读取任意文件，否则
   　　　　　　　　　　　　　　 对方传来的文件必须具有与指定字串相同的名字。
             　返回值为：
                 文件名字符串　　对方传来的文件名
                 文件属性        对方传来的文件属性
                 文件时间        对方传来的文件时间
                 文件大小        对方传来的文件大小
                 对方实际系列号  对方实际具有的系列号
                【注意】：如果对方未设置文件属性、时间或大小，则返回的可能是随机值
            依写请求打开外部文件时 　
　　　　　　　　输入参数为：
　　　　　　　   对方允许系列号　用来指定通信对方所必须具有的机器系列号
　　　　　　　　　　　　　　　　 为零时表示可以与任意机器通信。
　　　　　　　　 文件名字符串    指定外部文件所用的文件名, 对方必须指定相同的文件名或指定*字符串
                 文件属性        文件属性
                 文件时间        文件时间
                 文件大小        文件大小
            返回值为：
                 对方实际系列号  对方实际具有的系列号

    返回值：  0   打开成功
              1   通信超时
              2   链路错误
              6   通信被取消
              7   文件名不匹配
              8   非法方式
              10  外部文件已经被打开
              11  非法文件名
  */

  extern int  ExfRead(char far *RdBuff, unsigned int RdCount,
                      unsigned int far *ActRdCnt);
  /*
   23 数据包通信方式下读外部文件。
 　   参数：　
              RdBuff       读入缓冲区地址
　  　　　　  RdCount      读入长度（字节）
              ActRdCnt     实际读入长度（字节）
      返回参数：
              ActRdCnt     实际读入长度（字节）
      函数值：
              0            成功
              非0          失败
              错误代码
                   1   通信超时
                   2   链路错误
                   6   通信被取消
                   8   非法方式（外部文件未按读方式打开）
     【注释】   当实际读入长度小于指定读入长度时，表示外部文件已结束。
  */

  extern int  ExfWrite(char far *WrtBuff, unsigned int WrtCount,
                       unsigned int far *ActWrtCnt);
  /*
   24 数据包通信方式下写外部文件。
  　  参数：　　
               WrtBuff       写出缓冲区地址
 　 　　　　   WrtCount      写出长度（字节）
               ActWrtCnt     实际写出长度（字节）
      返回参数：
               ActWrtCnt     实际写出长度（字节）
      函数值：
               0             成功
               非0           失败
               错误代码
                   1   通信超时
                   2   链路错误
                   6   通信被取消
                   8   非法方式（外部文件未按写方式打开）
                   9   文件被截断（通信对方未读完所有写出字节便关闭了文件）
  */

  extern void ExfClose(void);
  /*
   25 数据包通信方式下关闭外部文件。
  　  参数：　　
               无
      返回参数：
	       无
      函数值：
	       无
  */

  extern int  SendClientReq(unsigned char ReqType, unsigned int ServerID,
	            	    char *DescString, unsigned int *AcceptComment);
  /* 
   26 向通信服务器提交客户请求(要求通信对方运行通信服务器)。
  　  参数：   ReqType    请求类型（0..255，'a'..'z'和'A'..'Z' 除外）
			    _DEL_REQ  删除文件请求
			    _SNO_REQ  获取系列号请求
 　   　　　   ServerID   服务器系列号（为零表明可与任何运行服务器软件的机器通信）
	       DescString 请求描述串
			    _DEL_REQ 时包含文件名
	       AcceptComment 接受备注
      返回参数：
               AcceptComment 接受备注
			   _SNO_REQ 被接收时返回取得的系列号
      函数值:  0   请求被接受
	       1   通信超时
	       2   链路错误
	       其他值 请求被拒绝时的原因码
  　 【注释】　请求描述串为任意长度不超过255个字节的字符串
  */

  extern int  ClientReqExist(unsigned char far *ReqType,
 		             REQ_DESC far *ReqDesc);
  /* 
   27  CommPlus 保留 
  */

  extern int  AcceptReq();
  /*
   28 CommPlus 保留 
  */

  extern int  RejectReq(unsigned int RejectReason);
  /*
   29 CommPlus 保留 
  */

  extern int  SendFileOut(char far *LocalfName, unsigned char ShowInfor,
                          unsigned char Language, unsigned int ReaderSNO,
                          char far *WrtBuff, unsigned int BuffSize);
  /*
   30 发送文件(要求通信对方运行接收文件)。
      参数：　　
               LocalfName   本地发送文件名
               ShowInfor    显示信息选择
                            _NOT_SLNT   显示通信信息
                            _SLNT       不显示通信信息
               Language     显示信息的语言(英,中)选择
                            _IN_CHI     使用中文
                            _IN_ENG     使用英文
               ReaderSNO    通信对方的机器系列号
               Wrtbuff      发送缓冲区地址
               Buffsize     缓冲区长度
      返回参数：
               无
      函数值：   
               0             成功
               非0           失败错误码
                             错误码详见错误码列表
  */

  extern int  CopyFileIn(char far *LocalfName, char far *RemotefName,
                         unsigned char ShowInfor,
                         unsigned char Language, unsigned int WriterSNO,
                         char far *RdBuff, unsigned int BuffSize);
  /*
   31 接收文件(要求通信对方运行发送文件)。
      参数：　　
               LocalfName   接收文件的本地(目的)名
               RemotefName  接收文件的远地(源)名
               ShowInfor    显示信息选择
                            _NOT_SLNT   显示通信信息
                            _SLNT       不显示通信信息
               Language     显示信息的语言(英,中)选择
                            _IN_CHI     使用中文
                            _IN_ENG     使用英文
               WriterSNO    通信对方的机器系列号
               Rdbuff       接收缓冲区地址 
               Buffsize     缓冲区长度
      返回参数：
               无
      函数值：   
               0             成功
               非0           失败错误码
                             错误码详见错误码列表
  */

  extern void fServer(unsigned char CommPort, unsigned int BaudRate,
                      unsigned char Silent, unsigned char LangSelect,
                      unsigned int BufferSize, char far *Buffer);
  /*
   32 通信服务器。
      参数:
               CommPort     串行口号
               BaudRate     波特率
               Silent       显示信息选择
                            _NOT_SLNT   显示通信信息
                            _SLNT       不显示通信信息
               LangSelect   显示信息的语言(英,中)选择
                            _IN_CHI     使用中文
                            _IN_ENG     使用英文?
               buffer       通信缓冲区地址
               BufferSize   缓冲区长度
      返回参数：
               无
      函数值：   
               无
  */

  extern int  ExfPut(char far *LocalfName, char far *RemotefName,
                     unsigned char ShowInfor,
                     unsigned char Language,
                     unsigned int ReaderSNO,
                     char far *WrtBuff, unsigned int BuffSize);
  /*
   33 面向通信服务器发送文件(要求通信对方运行通信服务器)。
      参数：　　
               LocalfName   文件的本地(源)名
               RemotefName  文件的远地(目的)名
               ShowInfor    显示信息选择
                            _NOT_SLNT   显示通信信息
                            _SLNT       不显示通信信息
               Language     显示信息的语言(英,中)选择
                            _IN_CHI     使用中文
                            _IN_ENG     使用英文
               ReaderSNO    通信对方的机器系列号
               Wrtbuff      发送缓冲区地址 
               Buffsize     缓冲区长度
      返回参数：
               无
      函数值：   
               0             成功
               非0           失败
               非0           失败错误码
                             错误码详见错误码列表
  */

  extern int  ExfGet(char far *LocalfName, char far *RemotefName,
	             unsigned char ShowInfor,
		     unsigned char Language,
		     unsigned int WriterSNO,
		     char far *RdBuff, unsigned int BuffSize);
  /*
   34 面向通信服务器取得文件(要求通信对方运行通信服务器)。
      参数：　　
               LocalfName   文件的本地(目的)名
               RemotefName  文件的远地(源)名
               ShowInfor    显示信息选择
                            _NOT_SLNT   显示通信信息
                            _SLNT       不显示通信信息
               Language     显示信息的语言(英,中)选择
                            _IN_CHI     使用中文
                            _IN_ENG     使用英文
               WriterSNO    通信对方的机器系列号
               Rdbuff       接受缓冲区地址 
               Buffsize     缓冲区长度
      返回参数：
               无
      函数值：   
               0             成功
               非0           失败错误码
			     错误码详见错误码列表
  */

  extern void SelectPort(unsigned char port);
  /*
 　35 选择通信口。
      参数：
	       port   通信口
                      0     串行口1（COM1）
                      1     串行口2（COM2）
      返回参数:
               无
      函数值：
               无
     【注释】HT-2800只有一个COM口，所以不论port的值是多少，都是串行口1（COM1）。
  */

  #endif