MDCUSSD网关软件使用手册2012.doc

《MDCUSSD网关软件使用手册2012.doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、MDCUSSD网关软件使用手册北京移数通电讯有限公司2012年4月目录1关于本文档31.1阅读对象32运行环境32.1硬件环境32.2软件环境32.3网络环境43软件运行43.1安装43.2运行43.3卸载54功能说明54.1USSD应用接口API54.1.1RegisterUssdCallbackFunctions54.1.2UssdSendBegin74.1.3UssdSendContinue84.1.4UssdSendRelease94.1.5UssdSendAbort94.1.6UssdSendSwitch104.1.7UssdSendCharge114.2USSD会话124.2.1会

2、话管理124.2.2超时处理124.2.3重连机制124.3缓存机制134.4错误代码131关于本文档本文档是MDCUSSD网关软件的使用说明。1.1阅读对象本文档的主要阅读对象为所有使用MDCUSSD网关软件人员和开发人员作为开发参考。2运行环境2.1硬件环境硬件最小配置推荐配置CPUPentiumIII 500MHzPentiumIII 1GHz显卡支持800×600，16位增强色，4MB显存 支持1024×768，32位增强色，16MB显存 内存128MB256MB硬盘至少具有40MB可用磁盘空间网卡Linux兼容网卡光驱CDROM驱动器2.2软件环境项目说明操作系统Linux应用程序M

3、DCUSSD网关软件1.1网络环境局域网，广域网环境。2软件运行2.1安装把MDCUSSD网关程序拷贝到指定目录下即可。2.2运行键入ussdproxy，会显示提示：输入相应的地址、端口、用户名和密码即可运行MDCUSSD网关程序。1.1卸载删除指定的安装目录即可。2功能说明2.1USSD应用接口API接口API分为两类，一是移动台上行到USSD业务应用的消息接口，一是USSD业务应用下发给移动台的消息接口。下面分别进行描述：2.1.1RegisterUssdCallbackFunctions通过此接口注册USSD消息处理回调函数，用来处理移动台上行到USSD业务应用的消息。【接口函数】int

4、RegisterUssdCallbackFunctions(TUssdCallbacksCallbackFuncs);【功能说明】向USSD协议层API注册USSD消息处理回调函数，当收到移动台上行的消息后，调用回调函数进行处理【数据结构】structTUssdCallbacks{LPONUSSDRECEIVEBEGINm_pOnUssdReceiveBegin;LPONUSSDRECEIVEUSERINPUTm_pOnUssdReceiveUserInput;LPONUSSDRECEIVEENDm_pOnUssdReceiveEnd;LPONUSSDRECEIVEABORTm_pOnUssd

5、ReceiveAbort;LPONUSSDTIMEOUTm_pOnUssdTimeOut;LPONUSSDCHGACKm_pOnUssdChgAck;};【返回值】函数执行成功返回0，否则返回USSD错误代码【详细描述】该函数向USSD协议层API注册消息回调函数，回调函数用于处理来自USSD业务中心的会话消息，这些回调函数的地址由CallbackFuncs指定。如果调用失败，则返回值为错误代码，成功则返回0【参数说明】CallbackFuncs-USSD回调函数的地址集【回调函数原型】1）UssdReceiveBegin消息的回调函数原型：typedefint(*LPONUSSDRECEIV

6、EBEGIN)(HANDLEhUssdDialog,TUssdDataUssdData,DWORD*pdwUssdAppParam);2）UssdReceiveUserInput消息的回调函数typedefint(*LPONUSSDRECEIVEUSERINPUT)(HANDLEhUssdDialog,charszUssdString[],DWORDdwUssdAppParam);3）UssdReceiveEnd消息的回调函数typedefint(*LPONUSSDRECEIVEEND)(HANDLEhUssdDialog,DWORDdwUssdAppParam);4）UssdReceiveA

7、bort消息的回调函数typedefint(*LPONUSSDRECEIVEABORT)(HANDLEhUssdDialog,DWORDdwErrorCode,DWORDdwUssdAppParam);5）UssdTimeout消息的回调函数typedefint(*LPONUSSDTIMEOUT)(HANDLEhUssdDialog,DWORDdwUssdAppParam);6）UssdCharg