控件模塊提示
本控件使用時需要SmsCore.dll和DBEngine.dll的支持,部署時必須放在同一目錄,所有DLL都不需要注冊。
控件類型庫名稱:JinDi SmsCom 2.0 TypeLib,引用后缺省名字空間JinDI_SmsComLib。具體使用范例請參考C# 的JinDiOcxDemo演示工程。
DLL模塊名稱
JindiSMSControl.ocx
金笛短信OCX模塊二次開發(fā)功能演示 如圖
控件使用說明
| 序號 |
屬性名稱 |
數據類型 |
說 明 |
| 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 |
發(fā)送短信是否請求狀態(tài)報告,由于跨網或CDMA等網絡不支持,所以一般不推薦使用,設置后對后續(xù)的所有發(fā)送請求有效直到被改變,運行時可讀寫 |
| 7 |
IsFlash |
Boolean |
是否請求發(fā)送閃爍短信,接收方是NOKIA的手機才能支持,一般不推薦使用,設置后對后續(xù)的所有發(fā)送請求有效直到被改變,運行時可讀寫 |
| 8 |
MsgID |
Long |
提交短信后生成的編號,運行時可讀寫,此ID主要用于群?⒑鴕觳椒⑺褪弊刺?通知標識,在一定時間段內需保證唯??/td>
|
| 9 |
SyncWorkMode |
Boolean |
是否同步工作方式,打開設備前設置對打開設備有效,發(fā)送短信前設置對發(fā)送短信有效,運行時可讀寫,同步方式時,直到打開設備成功或發(fā)送成功才返回 |
| 10 |
SignName |
String |
發(fā)送短信自動添加的簽名,運行時可讀寫,發(fā)送時自動在發(fā)送內容前面添加,格式:[簽名]:+內容。設置后對后續(xù)的所有發(fā)送請求有效直到被改變 |
| 11 |
Timeouts |
Integer |
AT指令執(zhí)行超時時間,缺省15秒,運行時可讀寫,設置后對后續(xù)操作生效 |
| 12 |
SendStartTime |
Date |
開始發(fā)送短信的開始時間,運行時可讀寫,缺省不需要設置,全天24小時可發(fā)送 |
| 13 |
SendEndTime |
Date |
結束發(fā)送短信的開始時間,運行時可讀寫。缺省不需要設置,全天24小時可發(fā)送 |
| 14 |
AutoSplite |
Boolean |
是否強制拆分長短信發(fā)送,運行時可讀寫。CDMA短信貓都是強制拆分,GSM短信貓可支持長短信發(fā)送,True表示強制。設置后對后續(xù)的所有發(fā)送請求有效直到被改變 |
| 15 |
CountryCode |
String |
國際代碼,缺省86表示中國,如果設為空,發(fā)送短信目標號碼都需要添加國際代碼,短信中心號碼設置也需要添加國際代碼。,運行時可讀寫 |
| 16 |
SendPriority |
Integer |
發(fā)送優(yōu)先級,1-32,缺省16,數越大,優(yōu)先級越高。如果在異步工作模式同時提交很多短信,優(yōu)先級高的優(yōu)先發(fā)送,設置后對后續(xù)的所有發(fā)送請求有效直到被改變,運行時可讀寫 |
| 17 |
EnglishMsg |
Boolean |
是否請求發(fā)送全英文短信,缺省False,如果設為True,包括簽名和內容,都需要是英文內容,否則對方接收后是亂碼,設置后對后續(xù)的所有發(fā)送請求有效直到被改變,運行時可讀寫 |
| 18 |
MsgValidMinute |
Integer |
發(fā)送短信的有效期,分鐘為單位,缺省一天1440,主要用于對方如果沒有開機,在有效期內開機,對方都可以收到短信。設置后對后續(xù)的所有發(fā)送請求有效直到被改變,運行時可讀寫 |
| 19 |
Signal |
Integer |
設備信號強度,運行時只讀,連接設備后可獲取,一般15-25算正常,信號過弱可能導致發(fā)送短信速度慢,失敗率也高。 |
| 20 |
ModemName |
String |
設備名稱,運行時只讀,連接設備后可獲取 |
| 21 |
ModemModel |
String |
設備型號,運行時只讀,連接設備后可獲取 |
| 22 |
ModemIMEI |
String |
設備IMEI唯一標識,個別設備是硬盤ID或MAC地址,運行時只讀,連接設備后可獲取 |
| 23 |
SimCardID |
String |
設備上SIM卡的卡號,主意不是手機號,運行時只讀,連接設備后可獲取 |
| 24 |
CallTransfer |
String |
呼叫轉移號碼,連接設備后可讀寫,CDMA設備不能獲取,只能寫,設為空表示取消呼叫轉移 |
| 25 |
WaitSend |
Integer |
當前設備等待發(fā)送的短信數量,運行時只讀,連接設備后可獲取 |
| 26 |
FirewareVerion |
String |
Fireware Verion,運行時只讀,連接設備后可獲取 |
| 27 |
ErrInfo |
String |
最近一次操作失敗或錯誤時的描述 |
方法
發(fā)送AT指令 (ATCommand)
功能描述:向端口發(fā)送AT指令
參 數:ATCmd 字符串 您要發(fā)送的AT指令
返 回:字符串 AT指令返回結果
關閉通訊端口 (CloseCom)
功能描述:關閉與設備的通訊端口
參 數:無
返 回:0 成功
其 它 失敗
刪除短消息 (DelMsgForIndex)
功能描述:刪除SIM卡中指定位置的短信
參 數:Index 字符串 要刪除SIM卡中短信的位置
返 回:0 刪除成功
其 他 刪除失敗
打開通訊端口 (OpenCom)
功能描述:打開與設備的通訊端口,調用前請先設置串口序號和通訊波特率
參 數:無
返 回:0 成功
其 他 失敗
讀取設備新收到的短消息 (ReadMsg)
功能描述:讀取設備新收到的短消息
參 數:OA 字符串 收到短信的來源號碼
Msg 字符串 收到短信的內容
TimeStamp 字符串 收到短信的時間
返 回:0 讀取成功
其 他 讀取失敗
讀取短消息 (ReadMsgForIndex)
功能描述:讀取SIM卡中指定位置的短消息
參 數:OA 字符串 收到短信的來源號碼
Msg 字符串 收到短信的內容
TimeStamp 字符串 收到短信的時間
Index 字符串 SIM中短信的位置
返 回:0 讀取成功
其 他 讀取失敗
發(fā)送短消息 (SendMsg)
功能描述:發(fā)送一條短信息
參 數:PhoneNo 字符串 對方的手機號碼
Msg 字符串 短消息內容
返 回:0 發(fā)送成功
其 他 發(fā)送失敗
發(fā)送wappush (SendWappush)
功能描述:發(fā)送一條短信息
參 數:PhoneNo 字符串 對方的手機號碼
Subject 字符串 wappush主題
URL 字符串 wappush Url
返 回:0 發(fā)送成功
其 他 發(fā)送失敗
短信數量 (GetSimNum)
功能描述:獲得當前SIM卡上的短信數量
參 數:pUsed ,數值,當前SIM卡上已經有的短信數量
返 回:pTotal,數值,SIM卡的短信容量
清理短信 (GetSimNum)
功能描述:清理SIM卡上所有短信
參 數:無
刪除指定范圍短信 (DelRangeMsg)
功能描述:刪除指定范圍內的所有短信
參 數:sStartPosition ,數值,起始序號 sEndPosition,數值,結束序號,如果起始序號等于結束序號,表示之刪除一條返回是否刪除成功標記
事件
NewMessage 當有新的短信到達時觸發(fā)這個事件
參 數:sMsgType 數值 來信類別,0表示普通文字短信,10表示接收到WAP PUSH sSimPosition 數值 來信在SIM卡上的序號,可根據此序號調用方法DelRangeMsg刪除
bstrFromNumber 字符串 來信號碼
bstrContent 字符串 來信內容
dtSentTime 日期 對方發(fā)送時間
ReceivedCall 當有來電時通知
參 數: bstrFromNumber 字符串 來電號碼
ConnectModemResult 異步打開設備時事件通知
參 數: bSucceed 真假 打開成功標記
SimCardNoMemory SIM卡已滿通知
無參數,這一般都是由于沒有及時調用刪除短信方法導致的,一般收到來信后及時刪除處理為好
SimCardNoMoney SIM已欠費通知
當發(fā)送時收到此事件,就無法再發(fā)送短信,需要及時充值或繳費才能繼續(xù)發(fā)送
SentMsgStatus 發(fā)送短信的狀態(tài)通知,一般群發(fā)或異步發(fā)送短信才有此事件
參 數:ulMsgID 數值 消息ID,提交短信后可獲取,提交短信前設置的話,提交一次將累加1
bstrDestNumber 字符串,目標號碼
bstrContent 字符串,目標內容
sSplitIndex 數值,拆分序號,只有長短信設置了強制拆分才會超過1,否則都是1
bSucceed 真假,是否發(fā)送成功標記