短讯接口API说明.doc

短讯接口API说明 第一章 概 述 短消息中心（SMC）和手机（MS）之间的联系，通过PLMN网，按照有关协议进行联系。而扩展短消息实体（ESME）和短消息中心之间的联系，ETSI规范中另有相关规定，GSM 03.39 SMPP协议等。ESME和SMSC之间通讯协议一般是TCPIP协议，上层协议可以是SMPP或者其他扩展协议。华为公司的M900 INtess-SMAX II系统提供的SMPP协议，对GSM 03.39 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）短讯业务函数 2.1 初始化与退出函数 1. IFInitInterface 【函数功能】 初始化接口，和短讯中心建立连接，应用程序必须首先调用本函数。 【预置条件】 smeidll.dll动态连接库必须在系统能够找到的目录下。 【函数原型】 BOOL WINAPI IFInitInterface(DWORD dwCodeProtocol, DWORD dwDriverProtocol, LPCTSTR pDriverParam); 【参数说明】 dwCodeProtocol 类型：DWORD 说明：和短讯中心连接的协议类型 取值 意义 1 内部协议（保留） 2 网关协议（保留） 3 SMEI协议 dwDriverProtocol 类型：DWORD 说明：和短讯中心连接的网络协议 取值 意义 1 TCP/IP协议 2 COM协议（保留） 3 X25协议（保留） PDriverParam 类型；LPCTSTR 说明：网络协议参数。字符串，参数之间以空格隔开。 例如：TCP/IP协议的参数为“IP地址 端口号 超时时间” （如“129.9.123.8 5016 5000”） 【返回值】 FALSE表示失败，TRUE表示成功。 【函数说明】 IFInitInterface用于初始化用户接口，定义接口的协议和使用的网络协议。使用该接口时，必须首先调用IFInitInterface，然后才能调用其他函数。 当低层链路出现故障后，如果用户没有注册出错处理函数，接口会调用缺省的出错处理函数，杀掉现在的接口，重新连接，建立新接口。 如果用户注册了出错处理函数，接口调用用户的回调函数，此时，接口已破坏，用户必须再次调用此函数，重新初始化接口，然后才能成功调用其他函数。 此函数在调用时，会杀掉当前的接口，不管当前接口是否出错。如果当前接口已经登录到SMSC，则重新初始化后，会自动调用Login函数，以上次登录的数据自动登录，当调用Logout函数后，上次登录的数据才会丢弃，无效。 dwCodeProtocol定义接口的编码协议，即ESME和SMSC之间的接口协议，取值有内部协议、SMPP协议、网关协议等。其中网关协议是网关和SMSC之间的协议，目前接口不提供。 dwDriverProtocol定义网络通讯协议，其中COM协议，X25协议，此版本保留，尚未提供。 pDriverParam定义网络协议的连接参数，对于不同的网络协议，参数不同。如果选择的协议是TCP/IP协议，则此参数应是按SMSC的IP地址，dwCodeProtocol定义的协议的端口号，连接超时时间顺序的字符串。其中端口号根据协议、厂家的不同有不同的值， 例如： 华为的短消息中心，SMEI协议的端口号是5016。 【调用举例】 IF