金笛短信二次开发控件 2009最新版

[波斯猫]

控件模块名称：JindiSMSControl.ocx
提示：
本控件使用时需要SmsCore.dll和DBEngine.dll的支持，部署时必须放在同一目录，本控件使用前必须先注册，其依赖的两个DLL不需要注册。
控件类型库名称：JinDi SmsCom 2.0 TypeLib，引用后缺省名字空间JinDI_SmsComLib。具体使用范例请参考C# 的JinDiOcxDemo演示工程。
控件使用说明
? 属性

序号 属性名称 数据类型 说明
1 AutoDelMsg Boolean 设置调用读取短信方法后是否要自动从SIM卡中删除对应的短信。
true自动删除 false不自动删除
默认为false，运行时可读写
2 CenterNo String ? SIM入网地的短信中心号码(SMCA)
自动从SIM卡中读取，运行时可读写
3 CommPort Integer ? 设备与计算机连接的串口号
默认值为1，运行时可读写
4 IsOpen Boolean ? 设备是否成功打开
运行时只读
True已打开 false未打开
5 Settings Long ? 设备与计算机的串口通讯的波特率
运行时可读写
默认值为115200，如果指定为0，自动判断波特率，一般不是115200就是9600
6 isStatusReport Boolean ? 发送短信是否请求状态报告，由于跨网或CDMA等网络不支持，所以一般不推荐使用，设置后对后续的所有发送请求有效直到被改变，运行时可读写
7 IsFlash Boolean ? 是否请求发送闪烁短信，接收方是NOKIA的手机才能支持，一般不推荐使用，设置后对后续的所有发送请求有效直到被改变，运行时可读写
8 MsgID Long ? 提交短信后生成的编号，运行时可读写，此ID主要用于群发和异步发送时状态通知标识，在一定时间段内需保证唯一
9 SyncWorkMode Boolean ? 是否同步工作方式，打开设备前设置对打开设备有效，发送短信前设置对发送短信有效，运行时可读写，同步方式时，直到打开设备成功或发送成功才返回
10 SignName String ? 发送短信自动添加的签名，运行时可读写，发送时自动在发送内容前面添加，格式：[签名]:+内容。设置后对后续的所有发送请求有效直到被改变
11 Timeouts Integer ? AT指令执行超时时间，缺省15秒，运行时可读写，设置后对后续操作生效
12 SendStartTime Date ? 开始发送短信的开始时间，运行时可读写，缺省不需要设置，全天24小时可发送
13 SendEndTime Date ? 结束发送短信的开始时间，运行时可读写。缺省不需要设置，全天24小时可发送
14 AutoSplite Boolean ? 是否强制拆分长短信发送，运行时可读写。CDMA短信猫都是强制拆分，GSM短信猫可支持长短信发送，True表示强制。设置后对后续的所有发送请求有效直到被改变
15 CountryCode String ? 国际代码，缺省86表示中国，如果设为空，发送短信目标号码都需要添加国际代码，短信中心号码设置也需要添加国际代码。，运行时可读写
16 SendPriority Integer ? 发送优先级，1-32，缺省16，数越大，优先级越高。如果在异步工作模式同时提交很多短信，优先级高的优先发送，设置后对后续的所有发送请求有效直到被改变，运行时可读写
17 EnglishMsg Boolean ? 是否请求发送全英文短信，缺省False，如果设为True，包括签名和内容，都需要是英文内容，否则对方接收后是乱码，设置后对后续的所有发送请求有效直到被改变，运行时可读写
18 MsgValidMinute Integer ? 发送短信的有效期，分钟为单位，缺省一天1440，主要用于对方如果没有开机，在有效期内开机，对方都可以收到短信。设置后对后续的所有发送请求有效直到被改变，运行时可读写
19 Signal Integer ? 设备信号强度，运行时只读，连接设备后可获取，一般15-25算正常，信号过弱可能导致发送短信速度慢，失败率也高。
20 ModemName String ? 设备名称，运行时只读，连接设备后可获取
21 ModemModel String ? 设备型号，运行时只读，连接设备后可获取
22 ModemIMEI String ? 设备IMEI唯一标识，个别设备是硬盘ID或MAC地址，运行时只读，连接设备后可获取
23 SimCardID String ? 设备上SIM卡的卡号，主意不是手机号，运行时只读，连接设备后可获取
24 CallTransfer String ? 呼叫转移号码，连接设备后可读写，CDMA设备不能获取，只能写，设为空表示取消呼叫转移
25 WaitSend Integer ? 当前设备等待发送的短信数量，运行时只读，连接设备后可获取
26 FirewareVerion String ? Fireware Verion，运行时只读，连接设备后可获取
27 ErrInfo String ? 最近一次操作失败或错误时的描述

? 方法
? 发送AT指令 （ATCommand）
功能描述：向端口发送AT指令
参数：ATCmd 字符串 您要发送的AT指令
返回：字符串 AT指令返回结果

? 关闭通讯端口 （CloseCom）
功能描述：关闭与设备的通讯端口
参数： 无
返回： 0 成功
其它 失败

? 删除短消息 （DelMsgForIndex）
功能描述：删除SIM卡中指定位置的短信
参数： Index 字符串 要删除SIM卡中短信的位置
返回： 0 删除成功
其他 删除失败
? 打开通讯端口 （OpenCom）
功能描述： 打开与设备的通讯端口，调用前请先设置串口序号和通讯波特率
参数： 无
返回： 0 成功
其他 失败

? 读取设备新收到的短消息 （ReadMsg）
功能描述：读取设备新收到的短消息
参数： OA 字符串 收到短信的来源号码
Msg 字符串 收到短信的内容
TimeStamp 字符串 收到短信的时间
返回： 0 读取成功
其他 读取失败

? 读取短消息 （ReadMsgForIndex）
功能描述：读取SIM卡中指定位置的短消息
参数： OA 字符串 收到短信的来源号码
Msg 字符串 收到短信的内容
TimeStamp 字符串 收到短信的时间
Index 字符串 SIM中短信的位置
返回： 0 读取成功
其他 读取失败


? 发送短消息 （SendMsg）
功能描述：发送一条短信息
参数： PhoneNo 字符串 对方的手机号码
Msg 字符串 短消息内容
返回： 0 发送成功
其他 发送失败
? 发送wappush （SendWappush）
功能描述：发送一条短信息
参数： PhoneNo 字符串 对方的手机号码
Subject 字符串 wappush主题
URL 字符串 wappush Url
返回： 0 发送成功
其他 发送失败

? 短信数量 （GetSimNum）
功能描述：获得当前SIM卡上的短信数量
参数： pUsed ，数值，当前SIM卡上已经有的短信数量
返回： pTotal，数值，SIM卡的短信容量

? 清理短信 （GetSimNum）
功能描述：清理SIM卡上所有短信
参数：无

? 删除指定范围短信 （DelRangeMsg）
功能描述：删除指定范围内的所有短信
参数： sStartPosition ，数值，起始序号
sEndPosition，数值，结束序号，如果起始序号等于结束序号，表示之删除一条
返回是否删除成功标记

? 事件
? NewMessage 当有新的短信到达时触发这个事件
参数： sMsgType 数值 来信类别，0表示普通文字短信，10表示接收到WAP PUSH
sSimPosition 数值 来信在SIM卡上的序号，可根据此序号调用方法DelRangeMsg删除
bstrFromNumber 字符串 来信号码
bstrContent 字符串 来信内容
dtSentTime 日期 对方发送时间

? ReceivedCall 当有来电时通知
参数 bstrFromNumber 字符串 来电号码
? ConnectModemResult 异步打开设备时事件通知
参数 bSucceed 真假 打开成功标记

? SimCardNoMemory SIM卡已满通知，无参数，这一般都是由于没有及时调用删除短信方法导致的，一般收到来信后及时删除处理为好
? SimCardNoMoney SIM已欠费通知，当发送时收到此事件，就无法再发送短信，需要及时充值或缴费才能继续发送。
? SentMsgStatus 发送短信的状态通知，一般群发或异步发送短信才有此事件
参数： ulMsgID 数值 消息ID，提交短信后可获取，提交短信前设置的话，提交一次将累加1
bstrDestNumber 字符串，目标号码
bstrContent 字符串，目标内容
sSplitIndex 数值，拆分序号，只有长短信设置了强制拆分才会超过1，否则都是1
bSucceed 真假，是否发送成功标记