控件模块提示
本控件使用时需要SmsCore.dll和DBEngine.dll的支持,部署时必须放在同一目录,所有DLL都不需要注册。
控件类型库名称:JinDi SmsCom 2.0 TypeLib,引用后缺省名字空间JinDI_SmsComLib。具体使用范例请参考C# 的JinDiOcxDemo演示工程。
DLL模块名称
JindiSMSControl.ocx
金笛短信OCX模块二次开发功能演示 如图
控件使用说明
序号 |
属性名称 |
数据类型 |
说 明 |
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主要用于群?⒑鸵觳椒⑺褪弊刺?通知标识,在一定时间段内需保证唯??/td>
|
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 真假,是否发送成功标记