您的位置:首页 > 其它

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

2007-10-27 09:18 1111 查看
2005年09月17日 16:05:00
如何使用Zealware提供的CNGPAPI进行网通短信网关程序开发?zealware.com提供 – mailto 介绍如何使用zealware.com提供的CNGP接口库开发网通短信网关程序。 下载接口库和示例程序(vc6.0) 接口库说明zealware提供的CNGPAPI接口库包含以下三个文件:cngp.h,cngpapi.lib,cngpapi.dll。cngp.h是接口库的头文件,包括cngp2.0的消息结构定义,和接口的导出函数定义。消息结构包括:CNGP_HEAD 协议消息头CNGP_SUBMIT SP下行包CNGP_SUBMIT_RESP SP下行包应答CNGP_DELIVER 网关上行包CNGP_DELIVER_RESP 上行包应答CNGP_STATUS_REPORT 状态报告MtStr 包括消息头和下行包应答定义MoStr 包括消息头和上行包定义二次开发时只需要用到MtStr和MoStr两种消息。提供的接口函数包括:1. Start - 启动函数定义:[align=left]CNGP_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 - SMGW设置的SP接入标识 pchPwd - 客户端密码 uchVersion - 协议版本号,目前是0x20 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.state);[/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, "CNGP", "123", /[/align][align=left] 0x13, OnDeliver);[/align][align=left] if (0 != nRetCode) {[/align][align=left] AfxMessageBox("Cngp 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]CNGP_API int __stdcall Submit(char* pchSPid, /[/align][align=left]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]unsigned char uchFeeUserType, /[/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 *sMsgid, /[/align][align=left]int & nStatus);[/align]参数说明:pchSPid - SP的企业代码[align=left]uchSubType - 短消息子类型(0=取消订阅,1=订阅或点播请求,2=点播下发,3=订阅下发,其他保留)[/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封顶
04包月扣费请求
05CR话单
其他保留
[align=left] [/align][align=left]uchFeeusertype - 计费用户类型字段(0:对目的终端计费, 1:对源终端计费, 2:对SP计费, 3:按照计费用户号码计费, 其他保留)[/align][align=left]pchFeeCode - 资费代码(单位为分),六位[/align][align=left]uchMsgFmt - 短消息格式[/align]
0ASCII编码
3短消息写卡操作
4二进制短消息
8UCS2编码
15包含汉字
[align=left] [/align][align=left]pchValidTime - 有效时间,格式遵循SMPP3.3协议,一般传入时填NULL即可[/align][align=left]pchAtTime - 定时发送时间,格式遵循SMPP3.3协议,一般传入时填NULL即可[/align][align=left]pchSrcTermId - 短消息发送用户号码[/align][align=left]pchChargeTermID - 计费用户号码,最长21位。[/align][align=left]uchDstTermCount - 短消息接收号码总数(≤100)。[/align][align=left]pchDstTermID - 短消息接收号码(连续存储DestTermIDCount个号码)。[/align][align=left]uchMsgLen - 消息内容长度。[/align][align=left]pchMsgContent - 消息内容,变长,按照协议要求最大254。[/align][align=left]sMsgid - 消息唯一标识[/align][align=left]nStatus - 消息提交结果,0-成功,其它-错误码。[/align][align=left] [/align]介绍:[align=left] 提交MT下行消息的函数,所有的字段都按照cngp协议的submit消息定义,具体可以参照协议5.4.4节。[/align]返回值:0 – 成功其它 – 错误码说明:[align=left] 如果由于网络原因,发送失败的话,接口库会自动重连,重新发送一次。如果Submit函数返回失败的话,表示消息根本就没有发送到网关,这是不会有submitresp返回,这时应用程序需要根据情况判断是否重发等等。(如果发到网关了,返回了submitresp,但是submitresp里面的status字段非零,表示消息已经发送到网关,只是由于字段填写错误,或者其他原因,网关没有继续往前传送,这又是另外一种错误情况了)[/align][align=left]另外接口库还提供另外一个函数,SubmitEx。和Submit函数的功能完全一样,只是传入参数由分别的几个字段变成了cngp_submit,传入前,需要首先给mt包赋值。定义如下:[/align][align=left]CNGP_API int __stdcall SubmitEx(cngp_submit mt, unsigned int & nSeqId)[/align][align=left]例子代码:[/align][align=left] int nRetCode = 0;[/align][align=left] int nStatus = 0;[/align][align=left] char sMsgid[10] = "";[/align][align=left] for (int ix=0; ix>10; ix++) {[/align][align=left] // 此处的字段都对应协议submit消息的字段[/align][align=left] nRetCode = Submit("3010123456", 1, 1, 1, /[/align][align=left] "9999", "01", 1, "3000", /[/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]CNGP_API int __stdcall Release()[/align]参数说明:[align=left] 无[/align]介绍: 停止个模块运行,关闭网关连接,释放资源。返回值:说明: 结束收发操作以后,需要调用Release函数来关闭连接,释放资源。也就是说调用Start函数以后,一定要调用Release函数。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=482777
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: 
相关文章推荐