infoX -API接口培训材料

i短消息API开发培训2003-01-14华为技术有限公司HUAWEI培训大纲基础知识培训（25分钟）•infoX信息平台介绍（10分钟）•CMPP2.0介绍（15分钟）API函数讲解(45分钟)•smeidll函数接口介绍（25分钟）•Unix函数接口介绍（10分钟）•Java函数接口介绍（10分钟）开发应用举例(30)•VCDemo•VBDemo答疑讨论(20分钟)HUAWEIinfoX短消息信息平台短消息信息平台系统概述短消息信息平台功能信息平台维测和管理网管与信息平台HUAWEIinfoX信息平台主要用途移动梦网网关（广东、江苏、浙江）短消息互联网关（移动，联通，固网）固网网关联通在线企业短消息网关等HUAWEI移动梦网网关拓扑图infoX-ISMGSP1SMSCmInternetISMGGNSSMSC1SPnSCP计费中心HUAWEI互联网关网络组网示意图移动向联通发送的短消息联通向移动发送的短消息联通向移动发送的短消息移动短消息中心联通短消息中心infoX（移动）infoX（联通）联通向移动发送的短消息移动向联通发送的短消息移动向联通发送的短消息HUAWEI短消息信息平台支持协议和遵循规范SMPP协议，CMPP协议,SGIP协议,SMGP协议遵循规范《短消息网关设备规范V1.2》《中国移动通信短消息网关测试规范V1.2》《中国移动通信资源站实体与互联网短消息网关接口协议V1.2》《神州行梦网业务SCP与ISMG之间通讯协议1.0》《点对点短消息网间互通协议V2.0》《点对点短消息网间测试规范V1.2》HUAWEIinfoX网关综合性能指标infoX平台性能指标:–最大消息处理能力1200条/秒–最大缓存消息数500万条–最大CMPP/SMPP端口数1000个–最大短消息中心接入数64个–最大缓存路由信息5000个HUAWEIinfoX短消息信息平台短消息信息平台系统概述短消息信息平台功能信息平台维测和管理网管与信息平台HUAWEI信息平台功能（一）路由管理接口管理，帐号管理消息实时跟踪鉴权管理记忆路由功能HUAWEI信息平台功能（二）鉴权管理记忆路由功能告警功能业务外包特性管理权限分级功能HUAWEI信息平台功能（三）主叫路由功能接口限制功能计费流水话单用户过滤主备接口功能业务优先级管理HUAWEIinfoX短消息信息平台短消息信息平台系统概述短消息信息平台功能信息平台维测和管理网管与信息平台HUAWEI主要功能–系统参数设置–帐号管理–协议跟踪–网关短信管理–数据日常维护。……综合网关维测台HUAWEIinfoX短消息信息平台短消息信息平台系统概述短消息信息平台功能信息平台维测和管理网管与信息平台HUAWEI网管维护管理infoXI2000MTSERVER上级综合网管统一网管集中监控配置管理实时告警统计管理HUAWEI培训大纲基础知识培训（25分钟）•infoX信息平台介绍（10分钟）•CMPP2.0介绍（15分钟）API函数讲解(45分钟)•smeidll函数接口介绍（25分钟）•Unix函数接口介绍（10分钟）•Java函数接口介绍（10分钟）开发应用举例(30)•VCDemo•VBDemo答疑讨论(20分钟)HUAWEISP和网关之间消息流建议通讯方式：长连接SPISMGCMPP_CONNECTCMPP_CONNECTt_RESPCMPP_SUBMITCMPP_SUBMIT_RESPCMPP_QUERYcCMPP_QUERY_RESPCMPP_CANCLECMPP_CANCLE_RESPCMPP_DELIVERCMPP_DELIVER_RESPHUAWEI培训大纲基础知识培训（25分钟）•infoX信息平台介绍（10分钟）•CMPP2.0介绍（15分钟）API函数讲解(45分钟)•smeidll函数接口介绍（25分钟）•Unix函数接口介绍（10分钟）•Java函数接口介绍（10分钟）开发应用举例(30)•VCDemo•VBDemo答疑讨论(20分钟)HUAWEI短消息平台系统结构SP：业务提供商程序SMEIDLL：动态库接口ISMG：infoX短消息网关HUAWEISMEIDLL接口的优点：Sp,CP,ICP,人工台、自动台、维测台等（统称为ESME扩展短消息实体）可以直接和ISMG按照CMPP或SMPP,SGIP,SMGP协议通讯，实现规范规定的有关服务。ESME和ISMG之间的通讯直接通过CMPP，SMPP等协议，是十分烦琐的，而且有许多工作是公共的，所以在M900INtess-SMAXII系统中提供了一些API函数，供ESME(SP,CP)直接使用，而不用ESME处理低层的TCPIP通信，及ISMG的握手等工作。通过这些API函数，将CMPP,SMPP等协议以API函数的形式提供给ESME使用。HUAWEISMEIDLL基本功能1.低层链路出现故障时，重连链路，提示上层。2.和ISMG的定时握手。3.提供实现CMPP和SMPP协议的API函数。API函数应用说明HUAWEI培训大纲基础知识培训（25分钟）•infoX信息平台介绍（10分钟）•CMPP2.0介绍（15分钟）API函数讲解(45分钟)•smeidll函数接口介绍（25分钟）•Unix函数接口介绍（10分钟）•Java函数接口介绍（10分钟）开发应用举例(30)•VCDemo•VBDemo答疑讨论(20分钟)HUAWEIVC中如何调用动态链接库Implict方式：必须包含三要素：1.在一个.h文件中，声明要调用的dll函数。示例为export.h(该.h文件是生成dll时创建的)。2.连接一个.lib文件(SMEIDLL.lib)，该文件包含dll的入口地址，用于程序运行时，操作系统来访问该dll。示例为SMEIDLL.lib(该.lib文件是生成dll时创建的)。3.在系统目录下安装.dll文件(SMEIDLL.dll)。HUAWEI初始化接口：//事件：点击主界面的“初始化”按钮voidCDemoDlg::OnInit(){//TODO:Addyourcontrolnotificationhandlercodehere//初始化接口：编码协议、通讯协议、通讯协议参数intiRet;iRet=IFInitInterface(3,1,10.108.22.8850165000);if(iRet!=0)MessageBox(初始化套接字成功!,MB_OK,0);elseMessageBox(初始化套接字失败!,MB_OK,0);}HUAWEI登陆：//事件：点击主界面的“初始化”按钮voidCDemoDlg::OnLogin(){//TODO:Addyourcontrolnotificationhandlercodehere//登录短讯中心：接口名、接口密码intiRet;iRet=Login_R(vp,);if(iRet!=0)MessageBox(登录成功!,MB_OK,0);elseMessageBox(登录失败!,MB_OK,0);}HUAWEI发送消息：//事件：点击主界面的“发送短讯”按钮voidCDemoDlg::OnSendSM(){//TODO:Addyourcontrolnotificationhandlercodehere//向短讯中心提交短消息，返回失败原因intiRet;unsignedlong*SM_ID;//返回：短消息unsignedchar*FCS;unsignedlongUDLen;LPCTSTRUserData;UserData=dfdgf;UDLen=strlen(UserData);iRet=SubmitAExEx(2,1,13902700001,2,1,968,0,0,0,0,0,0,0,5000,5000,100,0,UDLen,UserData,SM_ID,FCS);if(iRet==0)MessageBox(发送成功!,MB_OK,0);elseMessageBox(发送失败!,MB_OK,0);}HUAWEI获取消息：//事件：点击主界面的“获取消息”按钮voidCDemoDlg::OnGetSM(){//TODO:Addyourcontrolnotificationhandlercodehere//获取短消息的内容intiRet;ULONG*sm_ID=newULONG;unsignedchar*DestTON=newunsignedchar;unsignedchar*DestNPI=newunsignedchar;char*DestAddr=newchar;unsignedchar*OrgTON=newunsignedchar;unsignedchar*OrgNPI=newunsignedchar;char*OrgAddr=newchar;unsignedchar*PRI=newunsignedchar;unsignedchar*RP=newunsignedchar;unsignedchar*UDHI=newunsignedchar;unsignedchar*PID=newunsignedchar;unsignedchar*DCS=newunsignedchar;char*TimeStamp=newchar;unsignedlong*UDLen=newunsignedlong;char*UserData=newchar;HUAWEIiRet=GetDeliverSMExEx(sm_ID,DestTON,DestNPI,DestAddr,OrgTON,OrgNPI,OrgAddr,PRI,RP,UDHI,PID,DCS,TimeStamp,UDLen,UserData);if(iRet==0){MessageBox(接收成功！,MB_OK,0);CGetSMDlgdlg;//在此添加代码，在listbox框中显示该新短讯的各种状态。dlg.DoModal();}elseMessageBox(接收失败！,MB_OK,0);}HUAWEI演示一个DEMO程序。。。HUAWEI在公共模块中，全局声明对动态链接库(DLL)中外部过程的引用。利用publicdeclarefunction来声明,示例（IFInitInterface是dll中的一个函数）：PublicDeclareFunctionIFInitInterfaceLibsmeidll.dll(ByValdwCodeProtocolAsLong,ByValdwDriverProtocolAsLong,ByValpDriverParamAsString)AsLongVB中如何调用动态链接库HUAWEI登录SMSC用户修改配置参数初始化套接字,准备连接获取新短讯启动定时器发送新短讯定时器控件利用事件驱动，设计一个主界面：HUAWEIIFInitInterface调用方法：事件：点击主界面的“初始化”按钮功能:初始化套接字,准备连接PrivateSubcmdInitSocket_Click()DimbRetAsBooleanDimulRetAsLongDimiCountAsIntegerStatusBar1.Panels(1).Text=ulRet=IFInitInterface(CodeProtocol+1,DriverProtocol+1,_Trim(DriverParam))fStatusform.ProgressBar1.Value=100UnloadfStatusformIfulRet0ThenMsgBox初始化套接字成功!StatusBar1.Panels(1).Text=初始化连接成功ElseMsgBox初始化失败!StatusBar1.Panels(1).Text=初始化连接失败EndIfEndSubHUAWEILogin_R调用方法：事件：点击主界面的“登录服务器”按钮功