搜索
MDCUSSD网关软件使用手册第1页共13页MDCUSSD网关软件使用手册北京移数通电讯有限公司2012年4月MDCUSSD网关软件使用手册第2页共13页目录1关于本文档...............................................................................................................................31.1阅读对象.......................................................................................................................32运行环境...................................................................................................................................32.1硬件环境.......................................................................................................................32.2软件环境.......................................................................................................................32.3网络环境.......................................................................................................................43软件运行...................................................................................................................................43.1安装...............................................................................................................................43.2运行...............................................................................................................................43.3卸载...............................................................................................................................54功能说明...................................................................................................................................54.1USSD应用接口API....................................................................................................54.1.1RegisterUssdCallbackFunctions................................................................................54.1.2UssdSendBegin.........................................................................................................74.1.3UssdSendContinue....................................................................................................84.1.4UssdSendRelease......................................................................................................94.1.5UssdSendAbort.........................................................................................................94.1.6UssdSendSwitch......................................................................................................104.1.7UssdSendCharge.....................................................................................................114.2USSD会话.................................................................................................................124.2.1会话管理.................................................................................................................124.2.2超时处理.................................................................................................................124.2.3重连机制.................................................................................................................124.3缓存机制.....................................................................................................................134.4错误代码.....................................................................................................................13MDCUSSD网关软件使用手册第3页共13页1关于本文档本文档是MDCUSSD网关软件的使用说明。1.1阅读对象本文档的主要阅读对象为所有使用MDCUSSD网关软件人员和开发人员作为开发参考。2运行环境2.1硬件环境硬件最小配置推荐配置CPUPentiumIII500MHzPentiumIII1GHz显卡支持800×600，16位增强色，4MB显存支持1024×768，32位增强色，16MB显存内存128MB256MB硬盘至少具有40MB可用磁盘空间网卡Linux兼容网卡光驱CDROM驱动器2.2软件环境项目说明操作系统Linux应用程序MDCUSSD网关软件MDCUSSD网关软件使用手册第4页共13页2.3网络环境局域网，广域网环境。3软件运行3.1安装把MDCUSSD网关程序拷贝到指定目录下即可。3.2运行键入ussdproxy，会显示提示：输入相应的地址、端口、用户名和密码即可运行MDCUSSD网关程序。MDCUSSD网关软件使用手册第5页共13页3.3卸载删除指定的安装目录即可。4功能说明4.1USSD应用接口API接口API分为两类，一是移动台上行到USSD业务应用的消息接口，一是USSD业务应用下发给移动台的消息接口。下面分别进行描述：4.1.1RegisterUssdCallbackFunctions通过此接口注册USSD消息处理回调函数，用来处理移动台上行到USSD业务应用的消息。【接口函数】intRegisterUssdCallbackFunctions(TUssdCallbacksCallbackFuncs);【功能说明】向USSD协议层API注册USSD消息处理回调函数，当收到移动台上行的消息后，调用回调函数进行处理【数据结构】structTUssdCallbacks{LPONUSSDRECEIVEBEGINm_pOnUssdReceiveBegin;LPONUSSDRECEIVEUSERINPUTm_pOnUssdReceiveUserInput;LPONUSSDRECEIVEENDm_pOnUssdReceiveEnd;LPONUSSDRECEIVEABORTm_pOnUssdReceiveAbort;MDCUSSD网关软件使用手册第6页共13页LPONUSSDTIMEOUTm_pOnUssdTimeOut;LPONUSSDCHGACKm_pOnUssdChgAck;};【返回值】函数执行成功返回0，否则返回USSD错误代码【详细描述】该函数向USSD协议层API注册消息回调函数，回调函数用于处理来自USSD业务中心的会话消息，这些回调函数的地址由CallbackFuncs指定。如果调用失败，则返回值为错误代码，成功则返回0【参数说明】CallbackFuncs-USSD回调函数的地址集【回调函数原型】1）UssdReceiveBegin消息的回调函数原型：typedefint(*LPONUSSDRECEIVEBEGIN)(HANDLEhUssdDialog,TUssdDataUssdData,DWORD*pdwUssdAppParam);2）UssdReceiveUserInput消息的回调函数typedefint(*LPONUSSDRECEIVEUSERINPUT)(HANDLEhUssdDialog,charszUssdString[],DWORDdwUssdAppParam);3）UssdReceiveEnd消息的回调函数typedefint(*LPONUSSDRECEIVEEND)(HANDLEhUssdDialog,DWORDdwUssdAppParam);4）UssdReceiveAbort消息的回调函数typedefint(*LPONUSSDRECEIVEABORT)(HANDLEhUssdDialog,DWORDdwErrorCode,DWORDdwUssdAppParam);5）UssdTimeout消息的回调函数typedefint(*LPONUSSDTIMEOUT)(HANDLEhUssdDialog,MDCUSSD网关软件使用手册第7页共13页DWORDdwUssdAppParam);6）U