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

目 录 1 USSD业务API简介 2 2 基于USSD业务API的应用程序框架 2 3 USSD业务API描述 3 3.1 UssdInit 3 3.2 UssdExit 4 3.3 UssdLogin 4 3.4 UssdLogout 6 3.5 UssdIsConnectedOk 7 3.6 UssdGetErrorString 7 3.7 UssdReloadErrorInfoLib 8 3.8 UssdLocalOpen 9 3.9 UssdLocalClose 10 3.10 UssdSendRequest 11 3.11 UssdSendNotify 12 3.12 UssdSendResponse 13 3.13 UssdSendRelease 13 3.14 UssdSendAbort 14 3.15 UssdSendSwitch 15 3.16 UssdSendChargeInd 15 3.17 RegisterUssdCallbackFunctions 16 3.18 USSD会话处理 18 3.18.1 超时处理 18 3.18.2 连接断连处理 18 USSD业务API开发指南 USSD业务API简介 USSD业务API是对中国移动UAP协议的封装，支持中国移动的UAP协议。该API可以自动实现与USSD业务中心的连接管理，并可向上层应用提供当前连接状态。应用程序无需关心与USSD业务中心的连接，只需处理业务消息的收发及业务逻辑的实现即可。USSD业务API封装在一个动态库UssdClient.dll中，提供给用户使用。该API包含如下功能调用： 1. USSD业务客户端系统初始化 2. USSD业务客户端系统退出 3. USSD业务账号登录 4. USSD业务退出登录 5. USSD业务回调函数注册 6. USSD业务消息发送 7. USSD业务连接状态查询 8. USSD错误码标准说明的查询 9. USSD错误码表加载 通过上述功能用调用，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 int PASCAL UssdInit(char szServerAddress[], int nServicePort); 【返 回 值】 0 - 成功 其他 - USSD错误码，如要得到该错误码的说明，请调用UssdGetErrorString函数 【预置条件】 不能重复调用本函数，如果已成功地调用了UssdExit，则可以再次调用本函数 【详细描述】 UssdInit用于对业务客户端系统进行初始化，业务应用程序在调用任何其他API 函 数前，必须首先初始化客户端系统。 【参数说明】 szServerAddress - UssdServer的IP地址 nServicePort - UssdServer的业务接口端口号，该端口号由UssdServer的配置 文件指定，缺省为：4400 【调用示例】 int nErrorCode = UssdInit(10.108.26.186,4400); if( nErrorCode != 0） {