WAVECOM短消息动态链接库接口文档

短消息开发文档上海邦明软件有限公司1短信息开发包接口文档短消息开发文档上海邦明软件有限公司2目录TOC\o1-4\h\zHYPERLINK\l_Toc531163053
1．开发包说明PAGEREF_Toc531163053\h
3HYPERLINK\l_Toc531163054
2．接口函数一览表：PAGEREF_Toc531163054\h
43．动态库接口函数说明53．1模块控制函数53．1．1打开模块（OpenComm）.................................................................53．1．2关闭模块（CloseComm）.................................................................53．1．3强制关闭模块（ForceCloseComm）................................................63．2短信息处理函数...........................................................................................73．2．1发送短信息（SendMsg）..................................................................73．2．2接收短信（GetNewMsg）................................................................83．2．3取得发送队列中短信息数目（GetUnSendCount）........................83．2．4取得下一条发送的短信息（GetNextSendMsg）............................93．2．5获取发送失败短信（GetFailedMsg）............................................103．3短信中心设置函数.....................................................................................103．3．1取得短信中心号码（GetSCA）.....................................................103．3．2设置短信中心号码（SetSCA）......................................................114．在DELPHI中使用..............................................................................................124．1各接口函数说明.........................................................................................124．2函数申明.....................................................................................................124．3示例程序.....................................................................................................135．在VC中使用....................................................................................................135．1各接口函数说明.........................................................................................135．2在头文件里做函数申明：.........................................................................135．3调用函数.....................................................................................................146．在VB中使用....................................................................................................146．1各接口函数说明.........................................................................................146．2函数申明.....................................................................................................146．3示例程序.....................................................................................................15短消息开发文档上海邦明软件有限公司31．开发包说明包含文件列表：文件名称说明Dll/AscendComm.dll通讯动态连接库Dll/AscendSMS.dll短信息处理动态连接库Dll/AscendSMS.libLIB库文件(VC＋＋中使用)Dll/AscendSMS动态链接库接口文档帮助文件短消息开发文档上海邦明软件有限公司42．接口函数一览表：短消息开发文档上海邦明软件有限公司53．动态库接口函数说明3．1模块控制函数3．1．1打开模块（OpenComm）打开模块，以便进行短信息的收发操作。函数申明：调用语言函数申明VisualC++int__stdcallOpenComm(intComIndex);VisualBasicPublicDeclareFunctionOpenCommLib“AscendSMS.dll”(ByValCommIndexAsLong)AsLongDelphifunctionOpenComm(CommIndex:LongInt):LongInt;参数：参数说明ComIndex模块所连接的COM口编号函数返回：返回值说明0成功-5模块注册失败-6打开COM口失败-9未检测到GSM模块-10设置模块参数失败-11保存模块参数失败注意：OpenComm()函数要在调用其他接口函数前调用。3．1．2关闭模块（CloseComm）关闭模块，结束对模块的操作。函数申明：调用语言函数申明VisualC++int__stdcallCloseComm(intComIndex);VisualBasicPublicDeclareFunctionCloseCommLibAscendSMS.dll(ByValCommIndexAsLong)AsLong短消息开发文档上海邦明软件有限公司6DelphifunctionCloseComm(CommIndex:LongInt):LongInt;参数：返回值说明ComIndex模块所连接的COM口编号函数返回：返回值说明0成功-1发送队列中还有未发消息待发-7关闭COM口失败-8模块未打开3．1．3强制关闭模块（ForceCloseComm）强制关闭模块。函数申明：调用语言函数申明VisualC++int__stdcallForceCloseComm(intComIndex);VisualBasicPublicDeclareFunctionForceCloseCommLibAscendSMS.dll(ByValCommIndexAsLong)AsLongDelphifunctionForceCloseComm(CommIndex:LongInt):LongInt;参数：返回值说明ComIndex模块所连接的COM口编号函数返回：返回值说明0成功-7关闭COM口失败-8模块未打开注意：1)若队列中还有未处理消息，调用该函数将会丢失所以未处理短信2)建议调用该函数前先循环调用GetNextSendMsg将所有未发的短信依次取出，以便保存所有未发短信的信息，提高系统的可靠性，具体调用方法详见下文短消息开发文档上海邦明软件有限公司73．2短信息处理函数3．2．1发送短信息（SendMsg）发送消息，将要发送短信插入发送消息队列。函数申明：调用语言函数申明VisualC++int__stdcallSendMsg(intComIndex,char*Msg,char*Mobile,intMsg_Index,boolChinese);VisualBasicPublicDeclareFunctionSendMsgLibAscendSMS.dll(ByValCommIndexAsLong,ByValMsgAsString,ByValMobileNoAsString,ByValMsgIndexAsLong,ByValChineseAsBoolean)AsLongDelphifunctionSendMsg(CommIndex:LongInt;Msg:Pchar;MobileNo:Pchar;Msg_Index:LongInt;Chinese:Boolean):LongInt;参数：返回值说明ComIndex模块所连接的COM口编号Msg短消息内容MobileNo接收端手机号码，包括普通手机号码和特殊号码,如168Msg_Index消息序号，开发商自己定义，方便检索Chinese是否为中文信息（中文为True，否则为False）函数返回：返回值说明0成功，消息已插入发送队列-2消息长度超过最大长度-3手机号码不正确-4发送队列已满-8模块未打开注意：本系统采用异步方式发送短信，调用SendMsg函数发送成功的短信插入发送队列，由发送线程负责实际的发送，如果实际发送失败，系统将发送失败的短信转移到另一队列中，可以通过GetFailedMsg取得发送失败的短信，对于发送队列中尚未发送出去的短信，可以通过GetUnSendCount和GetNextSendMsg获取相关的信息，以便搭建可靠性高的应用系统，GetFailedMsg，GetUnSendCount，GetNextSendMsg的具体使用详见下文。返回参数为-8表示模块未打开，出现模块未打开有几种可能：模块确实没有打开短消息开发文档上海邦明软件有限公司8用户在调用之前先打开模块即可。模块出现异常在调用之前模块已经正常打开，但出现例如断电或串口连接出问题等等情况，系统会将串口关闭。在恢复正常后，用户必须重新打开模块才能继续使用。3．2．2接收短信（GetNewMsg）接收新的短信息。函数申明：调用语言函数申明VisualC++bool__stdcallGetNewMsg(intComIndex,char*NewMsg);VisualBasicPublicDeclareFunctionGetNewMsgLib“AscendSMS.dll”(ByValCommIndexAsLong,ByValNewMsgAsString)AsBooleanDelphifunctionGetNewMsg(CommIndex:LongInt;NewMsg:Pchar):B