中国联通 S G I P12短消息网关开发接口库使用手册.doc

中国联通SGIP1.2短消息网关开发接口库使用手册 软件作者 PrinceToad(范圣刚) 电子邮件 princetoad@ 发布时间 V1.41 2004/07/26 作者主页 Http:// MSN Princetoad2003@ OICQ 购买咨询电话 (010 更新历史 V1.41 Jul.26.04 加入了对远程网关IP地址的判断。 MO连接收到Unbind时，回复Resp. 修改了重发时的bug(不会出现result=255的错误了). V1.4 Jul.19.04 修正了一个返回函数指针错误的问题。(Special Thanks mate.) 增加了了程序启动模式,在Start函数里，当指定nLocalPort = -1时,不建立本地监听，只执行发送模块; 当指定nPeerPort = -1时,只进行监听，接收MO消息,不建立同网关的连接. V1.37 Jul.04.04 接口库增加了.net版本。 V1.36 Jun.07.04 修改了多连接分配时候的一个Bug,该Bug能够导致在流量比较大的时候丢失MT消息。 去除了除试用版过期的以外的其他消息提示对话框。 Start函数里面加了一个参数fOutputDebugInfo,用来指示是否输出调试信息，如果输出的话，DLL会在当前目录下建立一个文本文件debug.log,输出DLL的相关信息，用作调试，出现错误情况时可以查看该文件。 V1.34 Apr.13.04 1.修改了接收超时导致丢失MO消息的问题。 V1.33 Mar.30.04 1.根据联通的最新修改，LinkId字段不作为两个整数来处理，直接作为8字节的字符串处理。 V1.32 Mar.23.04 1.修改了连接中断后，重连的一个Bug. V1.3 Mar.07.04 1.修改了MT消息的发送方式,发送方式由原来的短连接(即一条消息建立一次连接)改为现在的长连接，提高了发送效率，减轻了网关负担，降低了出错率。 2.Start()函数增加了一个参数，允许用户自定义同网关建立的连接数，默认是3(网关连接的数目，具体要看网关允许同时建立多少个连接!)。 V1.28 Feb.27.04 1.还是根据《SGIPV1.2协议适应性修改0120(SP分册)》作了进一步修改。 2.根据协议变更，修改了Submit, Deliver, deliverstr结构体的定义， 在deliverstr结构中增加了linkid字段(2个四字节的整数)，同时将Submit,Deliver包中的原来的Reserved字段修改为LinkId(2个四字节的整数)。 3.修改了MO,MT消息收发函数,以适应协议的修改. 4.修改完善了示例程序，演示了在收到UCS2格式的MO消息是如何转换成可以正常显示的MultiByte编码. 5.升级了模拟网关，可以显示Submit消息的LinkId字段；同时可以在MO消息中设置LinkId的值。 V1.27 Feb.16.04 1.根据《SGIPV1.2协议适应性修改0120(SP分册)》作了相应修改.deliverstr结构中加入了char sLinkId[9]字段,用于返回Deliver消息的char Reserved[8]字段,现在被用来作为LinkId用。 V1.26 Jan.27.04 1.修正了MTError时，mt_err结构提没有带回DateTime的错误。 V1.25 Dec.22.03 1.在Submit函数中返回了submit消息包序列号中的时间戳(与Reponse和Report中的时间戳是对应的),通过时间戳与序列号的结合彻底解决了序列号唯一对应的问题(哪怕是系统重新启动). V1.24 Dec.04.03 1.更正了在接收消息包时未给ReportStr中的nSubmitSeqId字段赋值的错误。 2.更正了MTError返回时不能带回序列号的问题. 3.在ReportStr字段中加入新的字段unsigned int nSubmitDateTime,用于保存更加详细的Report内容. V1.23 Nov.25.03 1.MTErrorStr和MTRespStr两个消息结构中增加一个sgipg_submit字段，用于返回其对应的SUBMIT消息包，即这两个消息是由哪个SUBMIT包返回的,原因是SubmitResp包中并未包含开发者可能用到的必要信息(如手机号码等，虽然这些信息在Report消息里面包含的比较全面)。 V1.21 Nov.08.03 1.增加了函数CSgip::AddUserNumber(),可以方便地进行短消息群发. 2.增加了函数CSgip::GetSubmitSeqId(),功能是获得下