短信交换机开发口.docVIP

短信交换机开发接口 V12 部门 研发部 项目名称 文档用途 主题词 文档编号 文档版本号 V1.20 文档日期 2005- 更新日期 最后版本 文档作者 杨文强 2005-8- 2005-9-13 2005-11-15 V1,黑色字体 V1.1 蓝色字体 V12 褐色字体 项目负责人 杨文强 审核人 杨路  版本控制说明 版本 日期 拟稿和修改 说明 V1 2005-8-4 拟稿 说明了基本要求 V11 2005-9-13 新增 增加了新的接口，下传参数，来电显示 V12 2005-11-15 增加 发送短消息失败电信的错误信息返回 下载使用的接口 注： 宏变量定义 宏变量名称 数 值 宏 变 量 含 义 HARDWAREERR -1 硬件错误 CRCERR -4 数据包效验错 TIMEOUT -5 终端超时错误 _PhoneTimeOut -6 电话超时 DISCONNECT -7 终端主动断线挂机 SHORTCUTBACK -10 返回快捷键被按下 _SendFskErr -11 发送错误 _MenuItemErr -12 菜单错误 返回1表示线路忙 设备驱动函数说明 组件文件名：MsgModem.DLL(短信交换机) MsgModem.DLL中的主要函数清单： 函数名 概述 Init_serial 打开串口并设置参数。 Close_serial 关闭串口。 SendShortMessage 发送短消息 GetShortMessage 接受短消息 SendCenterNo 下传中心号码 GetModemParam 取短信交换机目前的设置参数 SetModemParam 设置短信交换机的参数 DelShortMsg 删除短信交换机里存储的短消息 ReadShortMsg 读短信交换机里存储的短消息 Init_serial——打开串口 函数描述 打开串口 填 表 人 杨文强 函数名 int Init_serial( int nPort, char * CommPara, DWORD pCall); 属性 变量名称 类型 变量含义 备 注 入口参数 nPort int 串口编号 1=COM1，2=COM2，依次类推 入口参数 ComParam char * 通信参数：速率,校验,数据位,停止位,流控。 如：9600,N,8,1 = 9600bps，无校验，数据位8，停止位1，无流控 入口参数 pCall DWORD 函数指针 回调使用 返回值 int 0=成功，-1=不能打开串口 备注： Close_serial——关闭串口 函数描述 关闭串口 填 表 人 杨文强 函数名 void Close_serial (); 属性 变量名称 类型 变量含义 备 注 备注： ShortMessageSend——发送短消息 函数描述 发送短消息 填 表 人 杨文强 函数名 int ShortMessageSend (char *pPhone1, char *pPhone2,char *pPhone3, char *pPhone4,char *pPhone5,char MailBox[5],char cSendId,char cFlag,unsigned char *pMessage,unsigned char *ErrorMsg,int TimeOut); 属性 变量名称 类型 变量含义 备 注 入口参数 pPhone1 char * 电话号码 第1个，空表示没有号码 入口参数 pPhone2 char * 电话号码 第2个，空表示没有号码 入口参数 pPhone3 char * 电话号码 第3个，空表示没有号码 入口参数 pPhone4 char * 电话号码 第4个，空表示没有号码 入口参数 pPhone5 char * 电话号码 第5个，空表示没有号码 入口参数 MailBox char * =string 接受方子信箱号，一共5个 字符’0’～’3’ 入口参数 cSendId Char =char 发件人的子信箱号 0：公共信箱 1：1号子信箱 2：2号子信箱 3：3号子信箱 入口参数 cFlag Char 回执标志 0：短消息发送无需回执 1：短消息发送需要回执 入口参数 pMessage unsigned char * 要发送的短消息 出口参数 ErrorMsg unsigned char * 错误信息 来自电信的短消息错误，包括发送号码错误等。 入口参数 TimeOut int 超时时间 单位秒 返回值 int 0=成功，-1=不能打开串口；其他：见宏定义 备注： GetShortMessage——接受短消息 函数描述 发