短讯接口API说明.doc

文档介绍：短讯接口API说明
第一章概述
短消息中心(SMC)和手机(MS)之间的联系,通过PLMN网,按照有关协议进行联系。而扩展短消息实体(ESME)和短消息中心之间的联系,ETSI规范中另有相关规定,GSM SMPP协议等。ESME和SMSC之间通讯协议一般是TCPIP协议,上层协议可以是SMPP或者其他扩展协议。华为公司的M900 INtess-SMAX II系统提供的SMPP协议,对GSM SMPP协议中的某些局限进行功能上的扩展,支持SMPP协议定义的所有功能。另外M900 INtess-SMAX II还提供了一套内部协议。
扩展短消息实体ESMEs(人工台、自动台、维测台等)可以直接和短消息中心按照SMPP或内部协议通讯,实现规范规定的有关服务。ESMEs和SMSC之间的通讯直接通过内部或SMPP协议,是十分烦琐,而且有许多工作是公共的,所以在M900 INtess-SMAX II系统中提供了一些API函数,供扩展短消息实体直接使用,而不用ESMEs处理低层的TCPIP通信,和SMSC的握手等工作。通过这些API函数,将SMPP协议或内部协议以API函数的形式提供给ESMEs使用。
ESME,用户接口(SMEIDLL),SMSC之间的关系图如下:
通过该接口可以用SMPP协议的格式和其他支持SMPP协议的SMSC进行通讯。
用户接口具有的功能有:
1. 低层链路出现故障时,重连链路,提示上层。
2. 和SMSC的定时握手。
3. 提供实现SMPP和内部协议中定义的相关协议的API函数。
第二章函数说明
短讯接口API可分为以下几类:
(1)初始化与退出函数
(2)短讯业务函数
初始化与退出函数
1. IFInitInterface
【函数功能】
初始化接口,和短讯中心建立连接,应用程序必须首先调用本函数。
【预置条件】
。
【函数原型】
BOOL WINAPI IFInitInterface(DWORD dwCodeProtocol, DWORD dwDriverProtocol, LPCTSTR pDriverParam);
【参数说明】
dwCodeProtocol 类型:DWORD
说明:和短讯中心连接的协议类型
取值 意义
1 内部协议(保留)
2 网关协议(保留)
3 SMEI协议
dwDriverProtocol 类型:DWORD
说明:和短讯中心连接的网络协议
取值 意义
1 TCP/IP协议
协议(保留)
3 X25协议(保留)
PDriverParam 类型;LPCTSTR
说明:网络协议参数。字符串,参数之间以空格隔开。
例如:TCP/IP协议的参数为“IP地址端口号超时时间”
(如“ 5016 5000”)
【返回值】
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, " 7000 5000 ");
【参考函数】
IFEx