如何使用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]
[align=left] [/align][align=left]uchFeeusertype - 计费用户类型字段(0:对目的终端计费, 1:对源终端计费, 2:对SP计费, 3:按照计费用户号码计费, 其他保留)[/align][align=left]pchFeeCode - 资费代码(单位为分),六位[/align][align=left]uchMsgFmt - 短消息格式[/align]
[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
如何使用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 | 包月扣费请求 |
05 | CR话单 |
其他 | 保留 |
0 | ASCII编码 |
3 | 短消息写卡操作 |
4 | 二进制短消息 |
8 | UCS2编码 |
15 | 包含汉字 |
Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=482777
相关文章推荐
- 如何使用Zealware提供的SMGPAPI进行固网小灵通短信网关程序开发?
- 使用VC进行程序开发时,如何引用外部的库
- 【hadoop】Hadoop学习笔记(九):如何在windows上使用eclipse远程连接hadoop进行程序开发
- Hadoop学习笔记(九):如何在windows上使用eclipse远程连接hadoop进行程序开发
- EXTJS4如何使用单个app程序来进行大型软件开发
- 如何正确使用javascript 来进行我们的程序开发
- 如何使用Linux Epoll来进行网络程序开发(译文)
- 如何在windows上使用eclipse远程连接hadoop进行程序开发
- 如何在windows上使用eclipse远程连接hadoop进行程序开发
- EXTJS4如何使用单个app程序来进行大型软件开发
- 如何正确使用javascript 来进行我们的程序开发
- 《使用wxWidgets进行跨平台程序开发》chap02——一个简单的应用程序
- 介绍如何使用 Jet OLE DB 提供程序 4.0 连接到不同的外部数据库
- windows上使用eclipse远程连接hadoop进行程序开发没有权限访问问题
- 【视频】高德开发者公开课—如何使用IOS SDK进行开发
- 如何 ︰ 执行批量更新和插入使用.NET 提供程序在 C#.NET OpenXML
- Android网络开发中如何使用JSON进行网络通信---Android JSON数据通讯方法解析
- .Net语言 APP开发平台——Smobiler学习日志:如何调用API进行短信发送
- 使用Eclipse RCP进行桌面程序开发(四):在Windows中使用Active X控件
- Android 软件开发之如何使用Eclipse Debug调试程序详解