技术文件技术文件名称：短消息网关客户端开发包使用详细说明技术文件编号：版本：V1.0文件质量等级：共11页(包括封面)拟制审核会签标准化批准深圳市中兴通讯股份有限公司---本文来源于网络，仅供参考，勿照抄，如有侵权请联系删除---目录短消息网关客户端开发包使用详细说明1功能说明短消息网关客户端开发包的主要功能是：为ICP(SP)应用提供标准的API接口，通过该接口,ICP可以基于CNGP协议和短消息网关SMGW通讯。该开发包具有以下特点。[1]与SMGW通讯既支持短连接方式也支持长连接方式；[2]支持CNGP协议；[3]参数配置功能；[4]友好的参数接口。2安装[1]把CNGPAPI软件包解压到一个目录。[2]修改,./config/cngpc.ini，修改IcpId（ICP编号）、IcpShareKey（ICP密码，缺省是123456789）、ClientIP（客户主机的IP地址）和ServerIP（短信网关地址）。[3]使用./Test/ActiveTest测试通讯链路和网关服务器端是否激活。[4]使用./Test/SendMsg尝试发送短消息。[5]使用./Test/RecvMsg尝试接收消息。[6]使用./Test/SendBatch尝试群发消息。3目录结构目录名子目录名文件名功能说明SmGw_Client_APIConfigcngpc.ini参数配置文件LibSmgwapi.lib网关客户端开发包Includecngpapi.h网关客户端开发包C头文件cngpdef.hCNGP协议头文件Test(unix平台)ActiveTest.exe链路测试文件SendMsg发送短消息测试文件RecvMsg接收短消息测试文件SendBatch.exe群发短消息测试文件sendmsgc.txt发送短消息缺省配置文件sendbatchmsgc.txt群发短消息缺省配置文件num.txt群发短消息目的号码配置文件Msg.txt短消息内容配置文件Example(win32平sendmsg.c发送短消息例子C源文件recvmsg.c接收短消息例子C源文件---本文来源于网络，仅供参考，勿照抄，如有侵权请联系删除---台)sendrecv.c接收发送短消息多线程例子C源文件4接口函数功能说明4.1初始化API函数函数名：InitCNGPAPI();功能：读取配置文件，完成初始化的工作。[1]系统资源的初始化：包括线程和线程同步所涉及的系统资源的创建和设置；定时资源的设置；通信消息机制的设置；内存管理的初始化设置，队列管理的设置。[2]通信参数初始化：包括服务器端IP地址；客户端器端IP地址；通信端口号。[3]业务参数初始化：包括：短信分割参数；短信最大长度；发送短信自动重试次数；发送请求超时时间等。[4]ICP参数初始化：ICP编号和密码。返回：0成功1失败4.2发送和接收函数4.2.1发送1条短信函数名：CNGPSendSingle()功能：向短信网关发送1条短信到1个话机用户。短信长度可以大于160，API能够自动分割短信。在发送过程中，如果因为通信原因导致发送失败，API能够自动重新发送。返回：0成功1失败4.2.2群发短信函数名：CNGPSendBatch()功能：向短信网关发送1条短信到多个手机用户。短信长度可以大于160，API能够自动分割短信。此函数使用文件传递短信内容。在发送过程中如果因为通信原因导致发送失败，API能够自动重新发送。返回：0成功1失败4.2.3获取群发短信结果函数名：GetSendBatchResp()功能：从文件里读取群发的某一个短信的标识、发送结果和发送号码。返回：0成功1失败4.2.4接收短信函数名：CNGPDeliver()功能：连接短信网关，等待接收属于本ICP的短信，需要输入等待的最大延时，如果是0表示永远等待。返回：0成功---本文来源于网络，仅供参考，勿照抄，如有侵权请联系删除---1失败4.2.5设置参数函数函数名：CNGPSetKey()功能：设置新的ICP密码返回：0成功1失败4.3查询和测试函数4.3.1检查短信网关是否能够提供服务函数名：CNGPActiveTest()功能：检查短信网关是否能够提供服务返回：0成功1失败4.3.2查询短消息信息函数名：CNGPQuery()功能：根据短消息服务ID号查询短消息信息返回：0成功1失败5函数参数和数据结构说明5.1初始化API函数参数名数据类型说明SINIFileconstchar*初试化函数配置文件名，缺省值（输入为空）是当前目录../cngpc.ini或者:../config/cngpc.ini例如：InitCNGPAPI（NULL）；如果上述目录没有配置文件，请输入完整的路径名。例如：InitCNGPAPI(“E:\SmGw_Client_API\config\cngpc.ini”)；5.2发送一条短消...