短消息网关客户端开发包使用详细说明.docVIP

FSK接入服务器网管软件需求规格说明书 (1.0) PAGE 第 PAGE 2 页 共 11 页 技 术 文 件 技术文件名称：短消息网关客户端开发包使用详细说明 技术文件编号： 版 本：V1.0 文件质量等级： 共11页 (包括封面) 拟 制 审 核 会 签 标准化 批 准 深圳市中兴通讯股份有限公司 短消息网关客户端开发包使用详细说明 PAGE 3 第 PAGE 4 页 共 10 页 固定网短讯平台实现QQ功能的方案 第 PAGE 0 页 共 SECTIONPAGES 10页 目录 TOC \o 1-3 \h \z 1 功能说明 2 2 安装 2 3 目录结构 2 4 接口函数功能说明 3 4.1 初始化API函数 3 4.2 发送和接收函数 3 4.2.1 发送1 条短信 3 4.2.2 群发短信 3 4.2.3 获取群发短信结果 3 4.2.4 接收短信 3 4.2.5 设置参数函数 4 4.3 查询和测试函数 4 4.3.1 检查短信网关是否能够提供服务 4 4.3.2 查询短消息信息 4 5 函数参数和数据结构说明 4 5.1 初始化API函数 4 5.2 发送一条短消息 4 5.3 群发短消息 5 5.4 获取群发短信结果 6 5.5 接收短信 7 5.6 设置参数函数 7 6 配置参数说明 7 7 短信的自动分割功能 8 8 编译说明 8 8.1 UINX平台 8 8.2 WINDOWS平台 8 9 网关客户端开发包支持的平台 8 10 例子程序说明 9 10.1 简单测试程序 9 10.2 综合测试程序 9 11 错误代码 9 12 其它说明 10 短消息网关客户端开发包使用详细说明 功能说明 短消息网关客户端开发包的主要功能是：为ICP(SP)应用提供标准的API接口，通过该接口,ICP可以基于CNGP协议和短消息网关SMGW通讯。 该开发包具有以下特点。 [1]与SMGW通讯既支持短连接方式也支持长连接方式； [2]支持CNGP协议； [3]参数配置功能； [4]友好的参数接口。 安装 [1]把CNGP API 软件包解压到一个目录。 [2]修改,./config/cngpc.ini ，修改IcpId （ICP 编号）、IcpShareKey （ICP密码，缺省是123456789）、ClientIP （客户主机的IP 地址）和ServerIP （短信网关地址）。 [3]使用./Test/ActiveTest测试通讯链路和网关服务器端是否激活。 [4]使用./Test/SendMsg 尝试发送短消息。 [5]使用./Test/RecvMsg尝试接收消息。 [6]使用./Test/SendBatch尝试群发消息。 目录结构 目录名 子目录名 文件名 功能说明 SmGw_Client_API Config cngpc.ini 参数配置文件 Lib Smgwapi.lib 网关客户端开发包 Include cngpapi.h 网关客户端开发包C头文件 cngpdef.h CNGP协议头文件 Test( unix平台) ActiveTest.exe 链路测试文件 SendMsg 发送短消息测试文件 RecvMsg 接收短消息测试文件 SendBatch.exe 群发短消息测试文件 sendmsgc.txt 发送短消息缺省配置文件