爱特生短信彩信ocx控件调用示例.doc

成都爱特生信息技术有限公司 短信彩信ocx控件调用示例 PAGE  PAGE 10 / 电话：02885448536 爱特生短信彩信ocx控件调用示例  TOC \o 1-3 \h \z \u  HYPERLINK \l _Toc133902491 一、典型调用方式  PAGEREF _Toc133902491 \h 2  HYPERLINK \l _Toc133902492 二、调用示例  PAGEREF _Toc133902492 \h 3  HYPERLINK \l _Toc133902493 2.1初始化模块  PAGEREF _Toc133902493 \h 3  HYPERLINK \l _Toc133902494 2.2连接设备  PAGEREF _Toc133902494 \h 3  HYPERLINK \l _Toc133902495 2.3收发彩信短信  PAGEREF _Toc133902495 \h 4  HYPERLINK \l _Toc133902496 2.4状态信息查询  PAGEREF _Toc133902496 \h 8  HYPERLINK \l _Toc133902497 2.5断开设备连接  PAGEREF _Toc133902497 \h 9  HYPERLINK \l _Toc133902498 三、参考资料  PAGEREF _Toc133902498 \h 10  一、典型调用方式 程序启动时初始化模块，设置控件为事件驱动模式； 连接设备； 通过接口函数来发送短信彩信，利用控件事件来接收短信、彩信、发送报告、设备状态改变等； 程序退出时，断开设备连接。 注：如果本控件采用非事件驱动模式，通常需要建立一个新线程来管理控件操作，相对要困难些，建议本控件采用事件驱动模式。 二、调用示例 约定：假设容器程序中添加的彩信控件名称为m_ctrlMMSOcx。 2.1初始化模块 2.1.1初始化函数 int nRes=m_ctrlMMSOcx.InitModel(C:\\RecvMMS,7,1,101,1); if(nRes0) MessageBox(初始化控件成功，已经找到加密狗。); else if(nRes==0) MessageBox(初始化失败！\r\n未找到软件加密狗。); else if(nRes==-4) MessageBox(初始化失败！\r\n不支持的加密狗类型参数。); 说明： 1、参数1指的是彩信工作路径，控件会在该创建彩信接收目录等。 2、参数2指的是彩信使用模型，7表示要求控件支持彩信短信的收发功能（1+2+4=7）。 3、参数3指的是彩信控件使用事件驱动模式工作。 4、参数4指的是彩信控件使用加密狗类型，此值固定为101（设备连接串口固定为com1）。 5、参数5指的是指收到彩信后要创建新的彩信接收文件目录，因为一个彩信里面通常包括了多个多媒体信息文件，所以建议创建一个新的目录来存储这些文件。 6、函数返回值的说明参见上面的代码中的提示信息。 2.2连接设备 2.2.1连接设备函数 int nRes=m_ctrlMMSOcx.ConnectModem(com1); if(nRes==1) MessageBox(正在启动连接设备过程。请稍候。); else if(nRes==-1) MessageBox(未成功初始化模块，请先进行控件初始化。); 说明： 1、参数1指的是彩信设备连接的com口名称。需要注意的是我们假设了彩信设备的连接波特率为115200，如果你的设备不是115200，请通过AT指令将你的彩信设备连接速率设为115200。注意：使用101类型加密狗时连接的com口名称固定为“com1”。 2、回值的说明参见上面的代码中的提示信息。 3、因为控件设为事件驱动方式工作，而彩信设备的检测和连接有个等待过程（约30秒钟），所以此函数的返回并没有说明设备是否连接成功，需要一个报告事件来告诉容器程序连接是否成功，此事件就是：ModemStatusChanged。 2.2.1设备状态变化事件 Void ModemStatusChanged (long ModemStatus) { if(ModemStatus==1) MessageBox(连接设备成功！); else if(ModemStatus==-1) MessageBox(连