短信猫二次开发DLL接口说明探析.doc

短信猫二次开发包DLL接口说明 版本说明： 3.86版－修改了3.85版接收重复信息和报告的错误 3.85版－增加了 WaveCom模块短信猫状态报告的支持 3.83版－增加了拨号功能参见后面的 （第七节 拨号说明） 3.81版－添加fnSetNationMode 函数，可以设置成国际模式，发送港、澳等号码 3.79版－更正到达时间，修改USB口猫电脑兼容性问题. 3.78版－延长信息到达的有效期. 3.76版－支持模块版8口猫，修改状态报告没有接收号码的错误 3.75版－支持Windows下Java接口 3.73版－修改了纯西文接收时，有时末尾出现@符号的问题。 3.72版－修改了信息状态报告返回的错误。 3.71版－修改了特殊字符的支持、增强了稳定性、修改了信息状态报告返回的错误。 3.70版－添加新函数,增加线程发送模式. fnSetThreadMode 3.69版－修正了fnSetDelayTime函数的调用错误 3.68版－支持最大256个端口，修正了fnWapPushCvt函数的返回错误 3.66版－支持到达报告功能，支持带电换卡功能，修改对某些信息长度判断错误的问题。 3.65版－修改了有些电脑检测不到短信猫的问题 3.63版－添加了两个函数fnSetDelayTime 和 fnWapPushCvt 3.62版－支持64个发送端口 3.61版－支持工业级短信猫，需要将类型设置成单口 3.58版－修改了对8口猫的支持错误, 支持纯西文发送到160个字节. 3.56版－加强了发送信息的稳定性. 3.55版－增加发送PUSH短信的功能，在fnSendMsg函数中添加了发送类型参数，读取返回信息函数也作了响应的修改。 目录 概述 编程说明 API函数列表 Java接口说明 错误代码 例子说明 概述 短信猫DLL接口提供API级的函数调用接口，接口完全底层调用，没有任何界面，适合于广大自主品牌的开发用户。函数接口简单，尽需几个简单的函数调用，就可以实现信息的发送和接收功能。调用结构图如下： 目前MonDem.DLL只支持Windows平台。 短信猫通过串行口（COM）和计算机相连，或者通过USB虚拟的串行口和计算机相连，我们这里编程都是对串行口进行的，有关串行口的信息可以在计算机系统属性中的设备列表中了解。 与短信猫同时提供了一个加密狗，它负责实现加密功能，我们也为用户提供了加密狗的接口（详见后面函数列表），方便用户实现软件的加密工作。 本文适合MonDem.DLL 版本3.55。 编程说明 用户使用MonDem.DLL编程的基本流程如下： 加载MonDem.DLL并定位函数，方法要视具体的编程语言而定。 调用fnSetModemType函数，设置相应的短信猫类型 执行初始化函数fnInitModem,可以指定打开某个端口，或者指定端口编号为-1，表示打开所有可能打开的端口。 调用fnSendMsg函数进行信息提交，同样可以指定用某个端口发送，或者-1表示用所有可能的端口进行发送。 以查询方式调用fnReadMsgEx接收信息（可在定时器里调用），本函数也可以指定单独端口或所有端口。本函数可以接收SIM卡接收到的信息，也可以接收由fnSendMsg发送信息的发送结果。具体请看函数说明部分。 退出程序前调用fnCloseModem关闭端口。 注：在发送之前可先用fnGetStatus函数得到端口状态，状态编号大于等于8，表示该端口设备连接正常，可以发送。 API函数列表 通讯部分 短信猫类型设置 long fnSetModemType(long ComNo,long modemType) 参数: nComNo 0~255 代表COM编号， modemType 短信猫类型 0 - 1口短信猫， 1 - 2口短信猫， 2 - 4口短信猫， 3 - 8短信猫口 返回: 0 - 成功， -1类型错 XXX -错误代码，参见代码表 获取当前短信猫类型设置 long fnGetModemType(long ComNo) 参数: nComNo 0~255 代表COM编号。 返回 ：短信猫类型 0 - 1口短信猫， 1 - 2口短信猫， 2 - 4口短信猫， 3 - 8短信猫口 XXX -错误代码，参见代码表 初始化函数 long fnInitModem (long nPortNo) 参数: nPortNo 0~255 代表端口号码， -1 表示所有端口 返回: 0 - 成功 XXX -错误代码，参见代码表 提交发送函数 long fnSendMsg (long nPortNo, char * szHeader, char * szMsg) 参数: nPortNo 0~255