华为USSDV280R001.2D503USSD业务API开发指南(中国移动UAP协议).doc

目录1 USSD业务API简介 22 基于USSD业务API的应用程序框架 23 USSD业务API描述 UssdInit UssdExit UssdLogin UssdLogout UssdIsConnectedOk UssdGetErrorString UssdReloadErrorInfoLib UssdLocalOpen UssdLocalClose UssdSendRequest UssdSendNotify UssdSendResponse UssdSendRelease UssdSendAbort UssdSendSwitch UssdSendChargeInd RegisterUssdCallbackFunctions USSD会话处理 超时处理 连接断连处理 18USSD业务API开发指南USSD业务API简介USSD业务API是对中国移动UAP协议的封装,支持中国移动的UAP协议。该API可以自动实现与USSD业务中心的连接管理,并可向上层应用提供当前连接状态。应用程序无需关心与USSD业务中心的连接,只需处理业务消息的收发及业务逻辑的实现即可。,提供给用户使用。该API包含如下功能调用:,USSD业务应用可以完成各种业务开发。关于USSD业务协议,请参见相应的文档《中国移动USSD业务协议接口规范》。基于USSD业务API的应用程序框架下面是一个典型的基于USSD业务API的应用程序的框架:应用程序通过提供回调函数来对接收的消息处理,并将其转发给USSD会话消息处理器。USSD会话消息处理器负责USSD会话的创建及删除。会话消息具体由相应的USSD会话对象处理,这些会话对象各自完成USSD状态机和会话功能,并通过API函数将要发出的会话消息发给UssdServer。USSD业务API描述本文以C语言的形式描述USSD业务API接口,不同语言编写的程序均可调用本API,但API对应的函数原型的形式应遵循该语言的语法。UssdInit【功能说明】初始化USSD业务客户端系统【函数原型】extern"C"intPASCALUssdInit(charszServerAddress[],intnServicePort);【返回值】0-成功其他-USSD错误码,如要得到该错误码的说明,请调用UssdGetErrorString函数【预置条件】不能重复调用本函数,如果已成功地调用了UssdExit,则可以再次调用本函数【详细描述】UssdInit用于对业务客户端系统进行初始化,业务应用程序在调用任何其他API函数前,必须首先初始化客户端系统。【参数说明】szServerAddress-UssdServer的IP地址nServicePort-UssdServer的业务接口端口号,该端口号由UssdServer的配置文件指定,缺省为:4400【调用示例】intnErrorCode=UssdInit("",4400);if(nErrorCode!=0){charszErrorString[100];charszInfo[100];UssdGetErrorString(nErrorCode,szErrorString);sprintf(szInfo,"USSD业务客户端初始化失败!\r\n错误内容:%s",szErrorString);MessageBox(NULL,szInfo,"UssdInit()调用示例",MB_OK);}else{MessageBox(NULL,,"USSD业务客户端初始化成功!","UssdInit()调用示例",MB_OK);}【相关调用】UssdExit、UssdGetErrorStringUssdExit【功能说明】退出USSD业务客户端系统【函数原型】extern"C"intPASCALUssdExit();【返回值】0-成功其他-USSD错误码,如要得到该错误码的说明,请调用UssdGetErrorString函数【预置条件】在调用本函数前,客户端系统应已成功地初始化,应用程序如果要重新初始化客