联通短信网关SP端应用程序接口使用说明(sgip1.2)

短信网关SP端应用程序接口使用说明
---- ZTE_SGIP_API
一、使用说明
本接口遵循SGIPv1.2 协议标准,以提供消息发送和接收函数的方式, 向ICP 提
供同联通网关进行信息交换的实现途径.客户可以依据具体需要,利用所提供的函数实现不同的连接方式(长连接和短连接)以及何时自动建立和中断连接, 除此之外, API 作为应用的接口,对SGIP 描述的其它功能,象流量控制重发机制和并发处理都不预干预,需要应用程序处理
二、函数说明：
1、设置源节点代码(set_src_node)
◆函数功能
依照SGIP1.2协议，设置源节点代码
◆返回值
无
◆参数说明：
2、与网关建立连接（SGIP_Connect）
◆函数功能
建立与网关间的连接
◆返回值
整型
>0 连接成功返回值标识一个连接，在以下的函数中使用
<0 连接失败
◆参数说明：
3、向网关提交信息(SGIP_Submit)
◆函数功能
向网关提交短信
◆返回值
=0 标识成功
<0 标识发送失败
◆参数说明：
1、如果建立好连接后一段时间没有发送消息，网关可能会关闭连接，
2、SGIP_Submit返回ERROR_SOCKET_CLOSE ,这时，必须重新建立连接并发送消息
3、p_seq1,p_seq2,p_seq3是函数返回的序列号，可与状态报告中的序列号对应
4、主动与网关断开连接（SGIP_Disconnect）
◆函数功能
主动和网关断开链接
◆返回值
=0 标识成功
<0 标识失败
◆参数说明：
5、等待并接收MO 消息（SGIP_Get_MO）
◆函数功能
等待并接收MO 消息
◆返回值
>0 标识成功收到MO消息,返回值是消息类型可能为MO_MSG或MO_REPORT
<0 标识发生错误:
◆参数说明：
◆注意：
1、应用程序必须自己建立监听socket,并将accept返回的socket标识传给SGIP_Get_MO
(参见test_mo例子)
2、如果没有MO消息将阻塞，直至MO消息到达或连接被网关关闭
3、返回ERROR_SOCKET_CLOSE并不是错误，只是网关关闭了连接
4、对收到的MO，应用程序要根据SGIP_Get_MO返回的类型。

三、结构体说明
1、MO消息
2、状态报告
四、常量说明
五、常见问题解答
1、为何联接到网关时网关回复ERROR_SOCKET_READ错误码？
答：造成此问题的原因很可能是你的IP同局方管理人员设置的IP不一致。

请与局方管理人员核对数据。

2、为何向网关提交短信时会返回ERROR_FEE_CODE错误码？
答：深讯信科网关要求资费类别为按条计费时资费代码不能为0；
3、接收MO消息时，为何进程会僵死？
答：造成此现象的原因很可能是api没有得到网关发来的MO或者状态报告包，处于阻塞等待状态。

4、为何和网关建立的MT链路经常会断开？
答：造成此问题的原因很可能是提交速度过快，以至超过网络的传输速度从而造成了网络阻塞。

六、Sp与网关间交易的基本流程
1、发送短信
2、接收短信。