双湾SGIPAPIWindows版使用说明

1、双湾SGIP API （Windows版）使用说明 1、安装 1. 1 API文件清单： API共包含6个文件，位于api_windows目录下: global, xboxdll. h xboxdll. dll xboxdl1ib、xboxp. ini usedll. exeb 1. 2测试方法： 请将以上文件拷贝到一个目录，修改配置文件xboxp. ini,然后执行usedll.exe，测试是否和Etot连 接成功。 2、API数据结构说明 2. 1结构Deliver,接收到一条服务请求的返回数据的格式 字段长度（字节）类型 说明 RecvType 1 Byte 记录类型，1为DELIVER

2、 SrcNo 22 Byte 主叫号码 邛Uid 1 Byte GSM协议类型，用于非Nokia手机下载铃声和图片，详 细解释请参考GSM03. 40中的923. 9 邛 Udhi 1 Byte GSM协议类型，用于非Nokia手机下载铃声和图片，详 细解释请参考GSM03. 40中的9. 2. 3. 23仅使用1位，右对 齐 Encoded 1 Byte 服务请求的编码，0为ASCII, 4为Bi nary, 15为GBK MsgLe ngth 2 Word 服务请求内容的长度 Msg 161 Byte 服务请求的内容 2.2结构Result,接收到一条发送结果的返回数据的格式 字段 长度（

3、字节） 类型 说明 RecvType 1 Byte 记录类型，2为DELIVER Oid 4 Un sig n ed 对应SendSMS调用的返回值或SendBatchSMS调用返 回的p Oid数 组兀素 CurrTimes 4 Un sig n ed 本次发送结果对应发送请求的已发送次数 Sen dTime 15 Byte 本次发送时间，格式为YYYYMMDDhhmmss Sen dMode 9 Byte 发送方式 DestNo 22 Byte 被叫号码 State 1 Byte 发送结果状态，S为成功，F为失败 ChargeNo 22 Byte 付费号码 2. 3联合Receive,由结

4、构Deliver和结构Result组成 字段 类型 st Deliver Struct Deliver Deliver的结构类型 st Receive Struct ResuIt Result的结构类型 3. API函数说明 3. 1发送单条短信SendSMS 作用：与服务器建立短连接，发送并接收到服务器返回后断开连接，连接失 败时重试3次，超时时间在xboxp. ini中设置，如果发送失败需重新调用本函数；本函数可以多线程调 用。 参数: 参数名数据类型说明 p DestNo void * 被叫手机号码，c字符串，最长21字节 p SvcType void * 服务类型，C字符串，最长10字

5、节 p Le ngth un sig ned 发送内容的长度，无符号整型，4字节 p Content void * 发送的内谷，字符型，长度为p Le ngth p TpUid byte 通常为0,仅用于向非Nokia手机发送铃声和图片 p TpUdhi byte 通常为0,仅用于向非Nokia手机发送铃声和图片 p_ScheduleTime void * 发送时间，C字符串，长度为14,格式为 YYYYWDDhhmmss,空串表示立即发送 p_ExpireTime void * 有效时间（分钟），无符号短整型，2字节，0为使用短信中 心缺省值 p Times word 发送次数，无符号短整型

6、，2字节，0无效 p_In terval word 每次发送的间隔时间（分钟），无符号短整型，2 字节，0无效 p_ChargeNo void * 付费手机号码，C字符串，最长21字节；如为NULL或空串 （0）表示由被叫付费；如为0表示由SP付费 返回： 大于零二成功 小于或等于零二失败 注：数据类型定义和错误代码见附录 3. 2发送多条短信SendBatchSMS 作用：发送一条短信息到多个手机参数: 参数名数据类型说明 p DestNo void * 被叫手机号码，c字符串，最长21字节 p SvcType void * 服务类型，C字符串，最长10字节 p Le ngth un sig

7、 ned 发送内容的长度，无符号整型，4字节 p Content void * 发送的内谷，字符型，长度为p Le ngth p_ScheduleTime void * 发送时间，C字符串，长度为14,格式为 YYYYMMDDhhmmss,空串表示立即发送 p_ExpireTime void * 有效时间（分钟），无符号短整型，2字节，0为使用短信中 心缺省值 p Times word 发送次数，无符号短整型，2字节，0无效 p_In terval word 每次发送的间隔时间（分钟），无符号短整型，2 字节，0无效 p_ChargeNo void * 付费手机号码，C字符串，最长21字节；如

8、为NULL或空串 （0）表示由被叫付费；如为0表示由SP付费 P_0id void * 无符号整型数组，元素个数等于被叫手机号码的个数，用于 存放返回的0ID 返回：p_Oid数组中非o值的个数 注：数据类型定义和错误代码见附录 3. 3接收函数RecvMsg 作用：接收一条或多条Deliver和Result。 参数： 参数名 数据类型 说明 p MaxRecv byte 最多接收Deliver和Result的条数，1字节 p Buffer void * 存放返回结果的缓冲区 返回：接收到服务请求和发送结果的条数 注：数据类型定义和错误代码见附录 4 调用方法 将global, h和xboxd

9、ll. h包含进调用函数的主程序,将xboxdll. lib加入工程,将xboxdll. dll拷到 当前目录或系统目录，将Xboxp. ini拷到当前目录；详细方法 请参考usedll程序的源代码 5 附录 5. 1数据类型定义： typedef un sig ned char *POINTER; tvpedef un sig ned short int UINT2; typedef un sig ned long int UINT4; typedef un sig ned char byte; typedef un sig ned short word; 52错误代码: 代码值 含义 0 数据库出错 -1 读xboxp. ini出错 -2 函数参数不符 -3 Socket版本不符 -4 创建Socket或连接服务器失败 -5 接受服务器端数据出错 -6 SendBatchSMS中手机个数超过255个 -100 分配内存空间失败 5. 3 xboxp. ini配置文件说明 Local SPC0DE = MD5KEY = DESKEY二 /*EtoT分配给SP的代码，4字节整型值*/ /*用于MD5计算摘要的KEY*/ /*用于DES加密的KEY,女口 SP不加密则没有该行*