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

本文主要是介绍如何使用Zealware提供的CNGPAPI进行网通短信网关程序开发?,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

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 - 启动函数
定义:
CNGP_API int __stdcall Start(const char *pchSmgIp, /
const int nSmgPort, /
const char *pchClientID, /
const char *pchPwd, /
const unsigned char uchVersion, /
void (__stdcall *pOnDeliver)(MoStr mo));
参数说明:
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文件观察具体原因。
传入回调函数指针其实比较简单,下面是例子代码:
// 处理上行消息的函数
void __stdcall OnDeliver(MoStr mo) {
if (0 == mo.pk_deliver.uchIsReport)
printf("手机号:%s, Mo内容:%s/n", mo.pk_deliver.sSrcTermId, mo.pk_deliver.MO_Msg_Content.sMsgcontent);
else
printf("Report状态:%s/n", mo.pk_deliver.MO_Msg_Content.csr.state);
}
int main(int argc, char* argv[])
{
int nRetCode = 0;
DWORD exitCode = 0;
WSADATA wsaData;
WSAStartup(MAKEWORD(2, 2), &wsaData);
nRetCode = Start("127.0.0.1", /
8890, "CNGP", "123", /
0x13, OnDeliver);
if (0 != nRetCode) {
AfxMessageBox("Cngp Client Start Error!");
return nRetCode;
}
Release();
WSACleanup();
return 0;
}
2. submit - 提交下行消息 (MT)
定义:
CNGP_API int __stdcall Submit(char* pchSPid, /
unsigned char uchSubType, /
unsigned char uchNeedReport, /
unsigned char uchPriority, /
char *pchServiceID, /
char *pchFeeType, /
unsigned char uchFeeUserType, /
char *pchFeeCode, /
unsigned char uchMsgFmt, /
char *pchValidTime, /
char *pchAtTime, /
char *pchSrcTermID, /
char *pchChargeTermID, /
unsigned char uchDstTermCount, /
char *pchDstTermID, /
unsigned char uchMsgLen, /
char *pchMsgContent, /
char *sMsgid, /
int & nStatus);
参数说明:
pchSPid - SP的企业代码
uchSubType - 短消息子类型(0=取消订阅,1=订阅或点播请求,2=点播下发,3=订阅下发,其他保留)
uchNeedReport - 是否要求返回状态报告(0=不要求,1=要求)
uchPriority - 发送优先级,0-9,填几都可以
pchSericeID - 业务类型,最长10位
pchFeeType - 收费类型,2位

00
免费
01
按条收费
02
包月
03
封顶
04
包月扣费请求
05
CR话单
其他
保留

uchFeeusertype - 计费用户类型字段(0:对目的终端计费, 1:对源终端计费, 2:对SP计费, 3:按照计费用户号码计费, 其他保留)
pchFeeCode - 资费代码(单位为分),六位
uchMsgFmt - 短消息格式

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

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


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


这篇关于如何使用Zealware提供的CNGPAPI进行网通短信网关程序开发?的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/616124

相关文章

中文分词jieba库的使用与实景应用(一)

知识星球:https://articles.zsxq.com/id_fxvgc803qmr2.html 目录 一.定义: 精确模式(默认模式): 全模式: 搜索引擎模式: paddle 模式(基于深度学习的分词模式): 二 自定义词典 三.文本解析   调整词出现的频率 四. 关键词提取 A. 基于TF-IDF算法的关键词提取 B. 基于TextRank算法的关键词提取

使用SecondaryNameNode恢复NameNode的数据

1)需求: NameNode进程挂了并且存储的数据也丢失了,如何恢复NameNode 此种方式恢复的数据可能存在小部分数据的丢失。 2)故障模拟 (1)kill -9 NameNode进程 [lytfly@hadoop102 current]$ kill -9 19886 (2)删除NameNode存储的数据(/opt/module/hadoop-3.1.4/data/tmp/dfs/na

Hadoop数据压缩使用介绍

一、压缩原则 (1)运算密集型的Job,少用压缩 (2)IO密集型的Job,多用压缩 二、压缩算法比较 三、压缩位置选择 四、压缩参数配置 1)为了支持多种压缩/解压缩算法,Hadoop引入了编码/解码器 2)要在Hadoop中启用压缩,可以配置如下参数

Makefile简明使用教程

文章目录 规则makefile文件的基本语法:加在命令前的特殊符号:.PHONY伪目标: Makefilev1 直观写法v2 加上中间过程v3 伪目标v4 变量 make 选项-f-n-C Make 是一种流行的构建工具,常用于将源代码转换成可执行文件或者其他形式的输出文件(如库文件、文档等)。Make 可以自动化地执行编译、链接等一系列操作。 规则 makefile文件

使用opencv优化图片(画面变清晰)

文章目录 需求影响照片清晰度的因素 实现降噪测试代码 锐化空间锐化Unsharp Masking频率域锐化对比测试 对比度增强常用算法对比测试 需求 对图像进行优化,使其看起来更清晰,同时保持尺寸不变,通常涉及到图像处理技术如锐化、降噪、对比度增强等 影响照片清晰度的因素 影响照片清晰度的因素有很多,主要可以从以下几个方面来分析 1. 拍摄设备 相机传感器:相机传

【Prometheus】PromQL向量匹配实现不同标签的向量数据进行运算

✨✨ 欢迎大家来到景天科技苑✨✨ 🎈🎈 养成好习惯,先赞后看哦~🎈🎈 🏆 作者简介:景天科技苑 🏆《头衔》:大厂架构师,华为云开发者社区专家博主,阿里云开发者社区专家博主,CSDN全栈领域优质创作者,掘金优秀博主,51CTO博客专家等。 🏆《博客》:Python全栈,前后端开发,小程序开发,人工智能,js逆向,App逆向,网络系统安全,数据分析,Django,fastapi

pdfmake生成pdf的使用

实际项目中有时会有根据填写的表单数据或者其他格式的数据,将数据自动填充到pdf文件中根据固定模板生成pdf文件的需求 文章目录 利用pdfmake生成pdf文件1.下载安装pdfmake第三方包2.封装生成pdf文件的共用配置3.生成pdf文件的文件模板内容4.调用方法生成pdf 利用pdfmake生成pdf文件 1.下载安装pdfmake第三方包 npm i pdfma

零基础学习Redis(10) -- zset类型命令使用

zset是有序集合,内部除了存储元素外,还会存储一个score,存储在zset中的元素会按照score的大小升序排列,不同元素的score可以重复,score相同的元素会按照元素的字典序排列。 1. zset常用命令 1.1 zadd  zadd key [NX | XX] [GT | LT]   [CH] [INCR] score member [score member ...]

业务中14个需要进行A/B测试的时刻[信息图]

在本指南中,我们将全面了解有关 A/B测试 的所有内容。 我们将介绍不同类型的A/B测试,如何有效地规划和启动测试,如何评估测试是否成功,您应该关注哪些指标,多年来我们发现的常见错误等等。 什么是A/B测试? A/B测试(有时称为“分割测试”)是一种实验类型,其中您创建两种或多种内容变体——如登录页面、电子邮件或广告——并将它们显示给不同的受众群体,以查看哪一种效果最好。 本质上,A/B测

git使用的说明总结

Git使用说明 下载安装(下载地址) macOS: Git - Downloading macOS Windows: Git - Downloading Windows Linux/Unix: Git (git-scm.com) 创建新仓库 本地创建新仓库:创建新文件夹,进入文件夹目录,执行指令 git init ,用以创建新的git 克隆仓库 执行指令用以创建一个本地仓库的