短信网关ICP端应用程序接口.doc

深讯信科短信网关SP端应用程序接口使用说明 深讯信科 PAGE  PAGE 2 短信网关SP端应用程序API使用说明 本文档适用于SP接入深讯网关CMPP20或CMPP30接口，对API中函数调用的说明： 文档中函数返回值定义常量 ERROR_OK 0 ERROR_SOCKET_CREATE -100 ERROR_CONNECT -101 ERROR_SOCKET_WRITE -102 ERROR_SOCKET_READ -103 ERROR_RSP_TIMEOUT -104 ERROR_BIND_FAILED -105 1．与网关建立连接函数int cmpp_connect(char *pip, char *pport, char *usrnm, char *usrpwd, CMPP_CONNECT_RSP *pcmpp_connect_rsp); 返回值： ERROR_SOCKET_CREATE socket创建失败 ERROR_CONNECT socket连接失败 ERROR_SOCKET_WRITE socket写失败 ERROR_SOCKET_READ socket读失败 ERROR_RSP_TIMEOUT 网关超时应答 0 socket操作成功的socket号 函数参数： param1: 网关IP param2: 网关端口（CMPP20 MT 7890 MO 7910 CMPP30 MT 7891 MO 7910） param3: SP的用户名（非SP_ID） param4: SP的密码 param5: 与网关的认证结果 2．向网关下发Submit消息 int cmpp_submit(int socketnumber, CMPP_SUBMIT *pcmpp_submit, CMPP_SUBMIT_RSP *pcmpp_submit_rsp); 返回值： ERROR_SOCKET_WRITE socket写失败 ERROR_SOCKET_READ socket读失败 ERROR_RSP_TIMEOUT 网关超时应答 ERROR_OK socket success 函数参数： param1: socket号，是cmpp_connect函数的返回值； param2: 用户填写需要发送的CMPP_SUBMIT包； param3: 查看网关的应答结果； 3．从网关收取消息，根据函数返回值判断收取的是什么类型的消息 int get_cmpp_deliver(int socketnumber, CMPP_DELIVER *pcmpp_deliver); 返回值： ERROR_SOCKET_WRITE socket写失败 ERROR_SOCKET_READ socket读失败 0 得到MO消息 1 得到状态报告 2 无消息返回 3 返回非CMPP_DELIVER消息 函数参数： param1: socket号，又cmpp_connect函数返回. param2: 返回DELIVER消息包。 3．向网关发送链路维测包函数，根据建立的连接不同，Submit链路用SubmitActiveTest下发，Deliver链路用DeliverActiveTest下发 int SubmitActiveTest( int socketnumber ); int DeliverActiveTest( int socketnumber ); 返回值： 成功 小于0 失败，失败后会主动关闭Socket套接字?? 函数参数 param1: socket号，由cmpp_connect函数返回. 4．断开与网关的连接 int cmpp_connect_terminate(int socketnumber); 返回值: 断开MO或MT连接成功 函数参数： param1: socket号，由cmpp_connect函数返回。