文档介绍：短讯接口API说明第一章概述短消息中心(SMC)和手机(MS)之间的联系,通过PLMN网,按照有关协议进行联系。而扩展短消息实体(ESME)和短消息中心之间的联系,ETSI规范中另有相关规定,。ESME和SMSC之间通讯协议一般是TCPIP协议,上层协议可以是SMPP或者其他扩展协议。华为公司的M900INtess-SMAXII系统提供的SMPP协议,,支持SMPP协议定义的所有功能。另外M900INtess-SMAXII还提供了一套内部协议。扩展短消息实体ESMEs(人工台、自动台、维测台等)可以直接和短消息中心按照SMPP或内部协议通讯,实现规范规定的有关服务。ESMEs和SMSC之间的通讯直接通过内部或SMPP协议,是十分烦琐,而且有许多工作是公共的,所以在M900INtess-SMAXII系统中提供了一些API函数,供扩展短消息实体直接使用,而不用ESMEs处理低层的TCPIP通信,和SMSC的握手等工作。通过这些API函数,将SMPP协议或内部协议以API函数的形式提供给ESMEs使用。ESME,用户接口(SMEIDLL),SMSC之间的关系图如下:通过该接口可以用SMPP协议的格式和其他支持SMPP协议的SMSC进行通讯。用户接口具有的功能有:,重连链路,提示上层。。。第二章函数说明短讯接口API可分为以下几类:(1)初始化与退出函数(2)【函数功能】初始化接口,和短讯中心建立连接,应用程序必须首先调用本函数。【预置条件】。【函数原型】BOOLWINAPIIFInitInterface(DWORDdwCodeProtocol,DWORDdwDriverProtocol,LPCTSTRpDriverParam);【参数说明】 dwCodeProtocol 类型:DWORD 说明:和短讯中心连接的协议类型取值 意义 1 内部协议(保留) 2 网关协议(保留) 3 SMEI协议 dwDriverProtocol 类型:DWORD 说明:和短讯中心连接的网络协议取值 意义 1 TCP/IP协议协议(保留) 3 X25协议(保留) PDriverParam 类型;LPCTSTR 说明:网络协议参数。字符串,参数之间以空格隔开。例如:TCP/IP协议的参数为“IP地址端口号超时时间”(如“”)【返回值】 FALSE表示失败,TRUE表示成功。【函数说明】 IFInitInterface用于初始化用户接口,定义接口的协议和使用的网络协议。使用该接口时,必须首先调用IFInitInterface,然后才能调用其他函数。当低层链路出现故障后,如果用户没有注册出错处理函数,接口会调用缺省的出错处理函数,杀掉现在的接口,重新连接,建立新接口。如果用户注册了出错处理函数,接口调用用户的回调函数,此时,接口已破坏,用户必须再次调用此函数,重新初始化接口,然后才能成功调用其他函数。此函数在调用时,会杀掉当前的接口,不管当前接口是否出错。如果当前接口已经登录到SMSC,则重新初始化后,会自动调用Login函数,以上次登录的数据自动登录,当调用Logout函数后,上次登录的数据才会丢弃,无效。 dwCodeProtocol定义接口的编码协议,即ESME和SMSC之间的接口协议,取值有内部协议、SMPP协议、网关协议等。其中网关协议是网关和SMSC之间的协议,目前接口不提供。 dwDriverProtocol定义网络通讯协议,协议,X25协议,此版本保留,尚未提供。 pDriverParam定义网络协议的连接参数,对于不同的网络协议,参数不同。如果选择的协议是TCP/IP协议,则此参数应是按SMSC的IP地址,dwCodeProtocol定义的协议的端口号,连接超时时间顺序的字符串。其中端口号根据协议、厂家的不同有不同的值,例如: 华为的短消息中心,SMEI协议的端口号是5016。【调用举例】IFInitInterface(1,1,"");【参考函数】 【函数功能】退出接口,应用程序在退出程序时必须调用此函数。【预置条件】加载了动态连接库。【函数原型】BOOLWINAPIIFExitInterface();【返回值】FALSE表示失败,TRUE表示成功【函数说明】此函数用于退出接口时,删除接口,释放