1、1i i短消息短消息APIAPI開發培訓開發培訓2003-01-14HUAWEIHUAWEI 培訓大綱b基礎知識培訓（25分鐘）infoX信息平臺介紹（10分鐘）CMPP2.0 介紹（15分鐘）bAPI 函數講解(45分鐘)smeidll 函數接口介紹（25分鐘）Unix 函數接口介紹（10分鐘）Java 函數接口介紹（10分鐘）b開發應用舉例(30)VCDemo VBDemob答疑討論(20分鐘)HUAWEIHUAWEI HUAWEIHUAWEIinfoX 信息平臺主要用途b移動夢網網關（廣東、江蘇、浙江）b短消息互聯網關（移動，聯通，固網）b固網網關b聯通在線b企業短消息網關等HUAWEI

2、HUAWEIinfoX-ISMGSP 1SMSC mInternetISMGGNSSMSC 1SP nSCP計費中心計費中心HUAWEIHUAWEI互聯網關網絡組網示意圖HUAWEIHUAWEI短消息信息平臺支持協議和遵循規范n短消息網關設備規范V1.2n中國移動通信短消息網關測試規范V1.2n中國移動通信資源站實體與互聯網短消息網關接口協議V1.2n神州行夢網業務SCP與ISMG之間通訊協議1.0n點對點短消息網間互通協議V2.0n點對點短消息網間測試規范V1.2HUAWEIHUAWEI HUAWEIHUAWEI HUAWEIHUAWEI信息平臺功能（一）b路由管理b接口管理，帳號管理b消息

3、實時跟蹤b鑒權管理b記憶路由功能HUAWEIHUAWEI信息平臺功能（二）b鑒權管理b記憶路由功能b告警功能b業務外包特性b管理權限分級功能HUAWEIHUAWEI信息平臺功能（三）b主叫路由功能b接口限制功能b計費流水話單b用戶過濾b主備接口功能b業務優先級管理HUAWEIHUAWEI HUAWEIHUAWEI主要功能系統參數設置帳號管理協議跟蹤網關短信管理數 據 日 常 維護。 綜合網關維測臺HUAWEIHUAWEI HUAWEIHUAWEI網管維護管理infoXI2000MT SERVER上級綜合網管上級綜合網管統一網管統一網管集中監控集中監控配置管理配置管理實時告警實時告警統計管理統計

4、管理HUAWEIHUAWEI培訓大綱b基礎知識培訓（25分鐘）infoX信息平臺介紹（10分鐘）CMPP2.0 介紹（15分鐘）bAPI 函數講解(45分鐘)smeidll 函數接口介紹（25分鐘）Unix 函數接口介紹（10分鐘）Java 函數接口介紹（10分鐘）b開發應用舉例(30)VCDemo VBDemob答疑討論(20分鐘)HUAWEIHUAWEISP 和網關之間消息流建議通訊方式：長連接 SP ISMGCMPP_CONNECTCMPP_CONNECTt_RESPCMPP_SUBMITCMPP_SUBMIT_RESPCMPP_QUERYcCMPP_QUERY_RESPCMPP_CAN

5、CLECMPP_CANCLE_RESPCMPP_DELIVERCMPP_DELIVER_RESPHUAWEIHUAWEI 培訓大綱b基礎知識培訓（25分鐘）infoX信息平臺介紹（10分鐘）CMPP2.0 介紹（15分鐘）bAPI 函數講解(45分鐘)smeidll 函數接口介紹（25分鐘）Unix 函數接口介紹（10分鐘）Java 函數接口介紹（10分鐘）b開發應用舉例(30)VCDemo VBDemob答疑討論(20分鐘)HUAWEIHUAWEI短消息平臺系統結構短消息平臺系統結構bSP： 業務提供商程序bSMEIDLL： 動態庫接口bISMG： infoX短消息網關HUAWEIHUAWE

6、ISMEIDLL接口的優點：接口的優點：bSp,CP,ICP,人工臺、自動臺、維測臺等（統稱為ESME擴展短消息實體）可以直接和ISMG按照CMPP或SMPP,SGIP,SMGP協議通訊，實現規范規定的有關服務。ESME和ISMG之間的通訊直接通過CMPP，SMPP等協議，是十分煩瑣的，而且有許多工作是公共的，所以在M900 INtess-SMAX II系統中提供了一些API函數，供ESME(SP,CP)直接使用，而不用ESME處理低層的TCPIP通信，及ISMG的握手等工作。通過這些API函數，將CMPP,SMPP等協議以API函數的形式提供給ESME使用。HUAWEIHUAWEISMEID

7、LL基本功能基本功能b1. 低層鏈路出現故障時，重連鏈路，提示上層。b2. 和ISMG的定時握手。b3. 提供實現CMPP和SMPP協議的API函數。API函數應用說明HUAWEIHUAWEI 培訓大綱b基礎知識培訓（25分鐘）infoX信息平臺介紹（10分鐘）CMPP2.0 介紹（15分鐘）bAPI 函數講解(45分鐘)smeidll 函數接口介紹（25分鐘）Unix 函數接口介紹（10分鐘）Java 函數接口介紹（10分鐘）b開發應用舉例(30)VCDemo VBDemob答疑討論(20分鐘)HUAWEIHUAWEIVC中如何調用動態鏈接庫中如何調用動態鏈接庫Implict方式：方式：必須

8、包含三要素：1. 在一個.h文件中，聲明要調用的dll函數。示例為export.h(該.h文件是生成dll時創建的)。2. 連接一個.lib文件(SMEIDLL.lib)，該文件包含dll的入口地址，用于程序運行時，操作系統來訪問該dll。示例為SMEIDLL.lib (該.lib文件是生成dll時創建的)。3.在系統目錄下安裝.dll文件(SMEIDLL.dll)。HUAWEIHUAWEI初始化接口：初始化接口：/事件：點擊主界面的事件：點擊主界面的“初始化初始化”按鈕按鈕void CDemoDlg:OnInit() / TODO: Add your control notification

9、 handler code here/初始化接口：編碼協議、通訊協議、通訊協議參數初始化接口：編碼協議、通訊協議、通訊協議參數int iRet;iRet=IFInitInterface( 3,1,8 5016 5000);if(iRet!=0)MessageBox(初始化套接字成功初始化套接字成功!,MB_OK,0);elseMessageBox(初始化套接字失敗初始化套接字失敗!,MB_OK,0);HUAWEIHUAWEI登陸：登陸：/事件：點擊主界面的事件：點擊主界面的“初始化初始化”按鈕按鈕void CDemoDlg:OnLogin() / TODO: Add yo

10、ur control notification handler code here/登錄短訊中心：接口名、接口密碼登錄短訊中心：接口名、接口密碼int iRet;iRet=Login_R(vp,);if(iRet!=0)MessageBox(登錄成功登錄成功!,MB_OK,0);elseMessageBox(登錄失敗登錄失敗!,MB_OK,0);HUAWEIHUAWEI發送消息：發送消息：/事件：點擊主界面的事件：點擊主界面的“發送短訊發送短訊”按鈕按鈕void CDemoDlg:OnSendSM() / TODO: Add your control notification handler

11、code here/向短訊中心提交短消息，返回失敗原因向短訊中心提交短消息，返回失敗原因int iRet;unsigned long* SM_ID;/返回：短消息返回：短消息unsigned char* FCS;unsigned long UDLen;LPCTSTR UserData;UserData=dfdgf;UDLen=strlen(UserData); iRet=SubmitAExEx(2,1, 2,1,968,0,0,0,0,0,0,0, 5000,5000, 100,0,UDLen,UserData,SM_ID,FCS);if(iRet=0)MessageBox(發送成功發送成功!

12、,MB_OK,0);elseMessageBox(發送失敗發送失敗!,MB_OK,0); HUAWEIHUAWEI獲取消息：獲取消息：/事件：點擊主界面的事件：點擊主界面的“獲取消息獲取消息”按鈕按鈕void CDemoDlg:OnGetSM() / TODO: Add your control notification handler code here/獲取短消息的內容獲取短消息的內容 int iRet;ULONG* sm_ID = new ULONG;unsigned char* DestTON = new unsigned char;unsigned char* DestNPI = n

13、ew unsigned char;char* DestAddr = new char;unsigned char* OrgTON = new unsigned char; unsigned char* OrgNPI = new unsigned char;char* OrgAddr =new char;unsigned char* PRI = new unsigned char;unsigned char* RP = new unsigned char;unsigned char* UDHI = new unsigned char;unsigned char* PID = new unsign

14、ed char;unsigned char* DCS = new unsigned char;char* TimeStamp = new char;unsigned long * UDLen = new unsigned long;char* UserData = new char;HUAWEIHUAWEI iRet = GetDeliverSMExEx(sm_ID,DestTON,DestNPI,DestAddr,OrgTON,OrgNPI, OrgAddr,PRI,RP, UDHI,PID, DCS,TimeStamp, UDLen,UserData);if(iRet = 0)Messag

15、eBox(接收成功！接收成功！,MB_OK,0);CGetSMDlg dlg; /在此添加代碼，在在此添加代碼，在listbox框中顯示該新短訊的各種狀態。框中顯示該新短訊的各種狀態。 dlg.DoModal();elseMessageBox(接收失敗！接收失敗！,MB_OK,0);HUAWEIHUAWEI演示一個DEMO程序。HUAWEIHUAWEI在公共模塊中，全局聲明對動態鏈接庫 (DLL) 中外部過程的引用。利用public declare function來聲明,示例（IFInitInterface 是dll中的一個函數）：Public Declare Function IFInit

16、Interface Lib smeidll.dll (ByVal dwCodeProtocol As Long,ByVal dwDriverProtocol As Long,ByVal pDriverParam As String ) As LongVB中如何調用動態鏈接庫中如何調用動態鏈接庫HUAWEIHUAWEI登錄SMSC用戶修改配置參數初始化套接字,準備連接獲取新短訊啟動定時器發送新短訊定時器控件利用事件驅動，設計一個主界面：利用事件驅動，設計一個主界面：HUAWEIHUAWEIIFInitInterface調用方法：調用方法：事件：點擊主界面的事件：點擊主界面的“初始化初始化”按鈕按

17、鈕功能功能:初始化套接字初始化套接字,準備連接準備連接Private Sub cmdInitSocket_Click()Dim bRet As BooleanDim ulRet As LongDim iCount As IntegerStatusBar1.Panels(1).Text = ulRet = IFInitInterface(CodeProtocol + 1, DriverProtocol + 1, _ Trim(DriverParam)fStatusform.ProgressBar1.Value = 100Unload fStatusformIf ulRet 0 Then MsgB

18、ox 初始化套接字成功初始化套接字成功! StatusBar1.Panels(1).Text = 初始化連接成功初始化連接成功Else MsgBox 初始化失敗初始化失敗! StatusBar1.Panels(1).Text = 初始化連接失敗初始化連接失敗End IfEnd SubHUAWEIHUAWEILogin_R調用方法：調用方法：事件：點擊主界面的事件：點擊主界面的“登錄服務器登錄服務器”按鈕按鈕功能功能:登錄服務器登錄服務器Private Sub cmdLogin_Click()Dim bRet As BooleanDim ulRet As LongStatusBar1.Panel

19、s(1).Text = ulRet = Login_R(Trim(SystemID), Trim(Password)If ulRet 0 Then MsgBox 登錄成功登錄成功! StatusBar1.Panels(1).Text = 登錄成功登錄成功Else MsgBox 登錄失敗登錄失敗! StatusBar1.Panels(1).Text = 登錄失敗登錄失敗End IfEnd SubHUAWEIHUAWEISubmitAExEx調用方法：調用方法：事件：點擊主界面的事件：點擊主界面的“發送短訊發送短訊”按鈕按鈕功能功能:向服務器提交短訊信息向服務器提交短訊信息Private Sub

20、cmdSubmit_Click()Dim result As IntegerDim UDLen As LongStatusBar1.Panels(1).Text = Dim UserData As StringUserData = test infoUDLen = Len(UserData)result = SubmitAExEx(OrgTON, OrgNPI, Trim(OrgAddr), DestTON, DestNPI, _ DestAddr, PRI, RD, RP, SRR, MR, DCS * 4, PID, _ Trim(Schedule), Trim(Expire), Defa

21、ult_ID, UDHI, UDLen, UserData, SM_ID, FCS)If result = 0 Then MsgBox 發送成功發送成功! StatusBar1.Panels(1).Text = 發送成功發送成功Else MsgBox 發送失敗發送失敗! StatusBar1.Panels(1).Text = 發送失敗發送失敗End IfEnd SubHUAWEIHUAWEI取取Deliver消息的調用方法：消息的調用方法：事件：點擊主界面的事件：點擊主界面的“獲取消息獲取消息”按鈕按鈕功能功能:判斷是否有新短訊發來判斷是否有新短訊發來,如果有如果有,則獲取該短訊的信息則獲取該

22、短訊的信息Private Sub cmdGetMsg_Click()StatusBar1.Panels(1).Text = GetMsgEnd Sub功能功能: 公共函數。判斷是否有新短訊發來；如果有公共函數。判斷是否有新短訊發來；如果有, 則獲取該短訊的信息則獲取該短訊的信息Sub GetMsg()Dim result As IntegerHDM_TimeOut = 2000result = HasDeliverMessage(HDM_TimeOut)If result = 0 Then MsgBox 你有新短訊你有新短訊! StatusBar1.Panels(1).Text = 有新短訊有

23、新短訊Else StatusBar1.Panels(1).Text = 無新短訊無新短訊End IfIf result = 0 Then result = GetDeliverSMExEx(SM_ID_R, DestTON_R, DestNPI_R, DestAddr_R, OrgTON_R, OrgNPI_R, OrgAddr_R, PRI_R, RP_R, UDHI_R, PID_R, DCS_R, TimeStamp_R, UDLen_R, UserData_R)HUAWEIHUAWEI If result = 0 Then MsgBox 接收短訊成功! StatusBar1.Panel

24、s(1).Text = 接受短訊成功 Set fNewSMForm = New frmNewSM fNewSMForm.List1.AddItem 短消息的ID： + CStr(SM_ID_R) fNewSMForm.List1.AddItem 目標地址號碼類型： + CStr(DestTON_R) fNewSMForm.List1.AddItem 目標地址編碼方案： + CStr(DestNPI_R) fNewSMForm.List1.AddItem 目標地址： + DestAddr_R fNewSMForm.List1.AddItem 源地址號碼類型： + CStr(OrgTON_R) fNewSMForm.List1.AddItem 源地址編碼方案： + CStr(OrgNPI_R) fNewSMForm.List1.AddItem 源地址： + OrgAddr_R fNewSMForm.List1.AddItem 回應路徑： + CStr(RP_R) fNewSMForm.List1.AddItem 頭結構指示： + CStr(UDHI_R) fNewS