如何使用Zealware提供的SMGPAPI进行固网小灵通短信网关程序开发?

2005年07月20日 23:47:00
如何使用Zealware提供的SMGPAPI进行固网小灵通短信网关程序开发？zealware.com提供 – mailto版本：1.1 - 2005-7-251．去掉了对submitresp的回调处理，submitresp消息直接在Submit()函数中返回，超时网关没有submitresp返回的话，返回错误码3，默认超时时间是5秒。 介绍如何使用zealware.com提供的SMGP接口库开发固网小灵通短信网关程序。 下载接口库和示例程序(vc6.0) 接口库说明zealware提供的SMGPAPI接口库包含以下三个文件：smgp.h,smgpapi.lib,smgpapi.dll。smgp.h是接口库的头文件，包括smgp1.38(修订整合版)的消息结构定义，和接口的导出函数定义。消息结构包括：SMGP_HEAD 协议消息头SMGP_SUBMIT SP下行包SMGP_SUBMIT_RESP SP下行包应答SMGP_DELIVER 网关上行包SMGP_DELIVER_RESP 上行包应答SMGP_STATUS_REPORT 状态报告MtStr 包括消息头和下行包应答定义MoStr 包括消息头和上行包定义二次开发时只需要用到MtStr和MoStr两种消息。提供的接口函数包括：1. Start - 启动函数定义：[align=left]SMGP_API int __stdcall Start(const char *pchSmgIp, /[/align][align=left] const int nSmgPort, /[/align][align=left]const char *pchClientID, /[/align][align=left]const char *pchPwd, /[/align][align=left] const unsigned char uchVersion, /[/align][align=left]void (__stdcall *pOnDeliver)(MoStr mo));[/align]参数说明： pchSmgIp - 网关IP地址 nSmgPort - 网关端口号 pchClientID - CP编号，最长8位，不足接口库会自动补齐 pchPwd - CP的登录密码 uchVersion - 协议版本号，目前是0x13 void (__stdcall *pOnDeliver(MoStr mo)) - 处理上行消息的回调函数指针（包括MO消息和状态报告）介绍：接口库启动，调用时传入连接网关的相关参数和MO消息处理回调函数指针，接口库会自动连接网关，并且启动消息收发和处理线程模块，各种处理自动进行。通过调用下面将要介绍的Submit函数，用户可以主动下发MT消息；上行消息（MO和状态报告）的接收将在接口库内自动进行，收到上行消息后，通过内部调度算法，调用用户自定义的消息处理函数pOnDeliver进行处理，消息内容作为参数传给用户定义的回调函数。返回值：0 – 成功其它 – 错误码说明：接口库启动后，会在当前目录生成trace.log文件，记录接口库的出错信息和运行情况，当出现错误时，可以打开trace.log文件观察具体原因。传入回调函数指针其实比较简单，下面是例子代码：[align=left]// 处理上行消息的函数[/align][align=left]void __stdcall OnDeliver(MoStr mo) {[/align][align=left] if (0 == mo.pk_deliver.uchIsReport)[/align][align=left] printf("手机号:%s, Mo内容:%s/n", mo.pk_deliver.sSrcTermId, mo.pk_deliver.MO_Msg_Content.sMsgcontent);[/align][align=left] else[/align][align=left] printf("Report状态:%s/n", mo.pk_deliver.MO_Msg_Content.csr.sStat);[/align][align=left]}[/align][align=left] [/align][align=left]int main(int argc, char* argv[])[/align][align=left]{[/align][align=left] int nRetCode = 0;[/align][align=left] DWORD exitCode = 0;[/align][align=left] [/align][align=left] WSADATA wsaData;[/align][align=left] WSAStartup(MAKEWORD(2, 2), &wsaData);[/align][align=left] [/align][align=left] nRetCode = Start("127.0.0.1", /[/align][align=left] 8890, "SMGP", "123", /[/align][align=left] 0x13, OnDeliver);[/align][align=left] if (0 != nRetCode) {[/align][align=left] AfxMessageBox("Smgp Client Start Error!");[/align][align=left] return nRetCode;[/align][align=left] }[/align][align=left] Release();[/align][align=left] [/align][align=left] WSACleanup();[/align][align=left] [/align][align=left] return 0;[/align][align=left]}[/align]2. submit - 提交下行消息(MT)定义：[align=left]SMGP_API int __stdcall Submit(unsigned char uchSubType, /[/align][align=left]unsigned char uchNeedReport, /[/align][align=left]unsigned char uchPriority, /[/align][align=left] char *pchServiceID, /[/align][align=left]char *pchFeeType, /[/align][align=left]char *pchFixedFee, /[/align][align=left]char *pchFeeCode, /[/align][align=left] unsigned char uchMsgFmt, /[/align][align=left]char *pchValidTime, /[/align][align=left]char *pchAtTime, /[/align][align=left] char *pchSrcTermID, /[/align][align=left]char *pchChargeTermID, /[/align][align=left]unsigned char uchDstTermCount, /[/align][align=left] char *pchDstTermID, /[/align][align=left]unsigned char uchMsgLen, /[/align][align=left]char *pchMsgContent, /[/align][align=left] char *pchReserved, /[/align][align=left] char *sMsgid, /[/align][align=left]int & nStatus);[/align]参数说明：[align=left]uchSubType - 短消息类型（1＝取消订阅，2＝订阅请求，3＝点播，4＝订阅，5＝交互式操作，6=查询，其他保留）[/align][align=left]uchNeedReport - 是否要求返回状态报告（0=不要求，1=要求）[/align][align=left]uchPriority - 发送优先级，0-9，填几都可以[/align][align=left]pchSericeID - 业务类型，最长10位[/align][align=left]pchFeeType - 收费类型，2位[/align]

00	免费
01	按条收费
02	包月
03	封顶
其他	保留

[align=left] [/align][align=left]pchFixedFee - 包月费/封顶费（单位为分），六位[/align][align=left]pchFeeCode - 资费代码（单位为分），六位[/align][align=left]uchMsgFmt - 短消息格式[/align]

0	ASCII编码
3	短消息写卡操作
4	二进制短消息
8	UCS2编码
15	包含汉字

[align=left] [/align][align=left]pchValidTime - 有效时间，格式遵循SMPP3.3协议，一般传入时填NULL即可[/align][align=left]pchAtTime - 定时发送时间，格式遵循SMPP3.3协议，一般传入时填NULL即可[/align][align=left]pchSrcTermId - 短消息发送用户号码118＋CP代码[/align][align=left]pchChargeTermID - 计费用户号码，最长21位。[/align][align=left]uchDstTermCount - 短消息接收号码总数（≤100）。[/align][align=left]pchDstTermID - 短消息接收号码（连续存储DestTermIDCount个号码）。[/align][align=left]uchMsgLen - 消息内容长度。[/align][align=left]pchMsgContent - 消息内容，变长，按照协议要求最大252。[/align][align=left]pchReserved - 保留，8位，传入时填NULL即可，这里保留这个参数是为了兼容以后的协议升级。[/align][align=left]sMsgid - 消息唯一标识[/align][align=left]nStatus - 消息提交结果，0-成功，其它-错误码。[/align][align=left] [/align]介绍：[align=left] 提交MT下行消息的函数，所有的字段都按照smgp协议的submit消息定义，具体可以参照协议5.3.3节。[/align]返回值：0 – 成功其它 – 错误码说明：[align=left] 如果由于网络原因，发送失败的话，接口库会自动重连，重新发送一次。如果Submit函数返回失败的话，表示消息根本就没有发送到网关，这是不会有submitresp返回，这时应用程序需要根据情况判断是否重发等等。（如果发到网关了，返回了submitresp,但是submitresp里面的status字段非零，表示消息已经发送到网关，只是由于字段填写错误，或者其他原因，网关没有继续往前传送，这又是另外一种错误情况了）[/align][align=left]另外接口库还提供另外一个函数，SubmitEx。和Submit函数的功能完全一样，只是传入参数由分别的几个字段变成了smgp_submit，传入前，需要首先给mt包赋值。定义如下：[/align][align=left]SMGP_API int __stdcall SubmitEx(smgp_submit mt, unsigned int & nSeqId)[/align][align=left]例子代码：[/align][align=left] int nRetCode = 0;[/align][align=left] unsigned int nSeqId;[/align][align=left] char sMsgid[10] = "";[/align][align=left] int nStatus = 0;[/align][align=left] [/align][align=left] for (int ix=0; ix>10; ix++) {[/align][align=left] // 此处的字段都对应协议submit消息的字段[/align][align=left] nRetCode = Submit(1, 1, 1, /[/align][align=left] "9999", "01", "3000", "02", /[/align][align=left] 15, "", "", /[/align][align=left] "13911638108", "13911638109", 1, /[/align][align=left] "13911638110", 4, "test", /[/align][align=left] "", sMsgid, nStatus);[/align][align=left] [/align][align=left] if (0 != nRetCode) {[/align][align=left] if ( 3 == nRetCode ) {[/align][align=left] printf("超时无返回!/n");[/align][align=left] }[/align][align=left] else {[/align][align=left] printf("Submit Error:%d./n", nRetCode);[/align][align=left]}[/align][align=left] }[/align][align=left] else {[/align][align=left] printf("Submit Success!>msgid = %s, status = %d3. Release - 关闭连接，释放接口库定义：[align=left]SMGP_API int __stdcall Release()[/align]参数说明：[align=left] 无[/align]介绍： 停止个模块运行，关闭网关连接，释放资源。返回值：无说明： 结束收发操作以后，需要调用Release函数来关闭连接，释放资源。也就是说调用Start函数以后，一定要调用Release函数。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=430129