Socket to Air Windows COM元件 使用說明

• 系統需求：Windows
  
• 元件註冊方法：(使用前必須先註冊)
  
  1. 將S2ACOM.dll複製到Windows系統目錄中，如C:\WinNT\System32\。
  
  2. 於Windows開始->執行的視窗中，輸入指令 regsvr32 C:\WinNT\System32\S2ACOM.dll
  
  3. 如出現以下視窗，即代表元件註冊成功。
  
     
  
  
• 元件函式說明：
  
  

  函式名稱	說明
  StartCon(ServerIP,ServerPort,UserID,Passwd,ret_code)	建立與伺服器的連線
  SendMsg(MobileNum,Message,ret_code,ret_description)	傳送簡訊
  SendMsg_Order(MobileNum,Message,Send_Time,ret_code,ret_description)	傳送預約簡訊
  QueryMsg(MobileNum,MessageID,ret_code,ret_description)	查詢簡訊傳送結果
  EndCon( )	結束與伺服器的連線

  函式參數說明：

  參數名稱	參數型態	in/out	內容	說明
  ServerIP	BSTR	[in]	Socket to Air伺服器IP	203.66.172.131
  ServerPort	BSTR	[in]	Socket to Air伺服器Port	8000
  UserID	BSTR	[in]	登入帳號	最長8個字元
  Passwd	BSTR	[in]	登入密碼	最長16個字元
  MobileNum	BSTR	[in]	手機號碼	固定為10個字元
  Message	BSTR	[in]	簡訊內容	最長為159個字元
  Send_Time	BSTR	[in]	預約傳送的時間	格式:YYMMDDHHMM00(12字元)
  ret_code	int	[out]	系統回傳的code	系統回傳的ret_code
  ret_description	BSTR	[out]	系統回傳的訊息字串	系統回傳的ret_description

  註1：ret_code與ret_description為系統回傳值，其值得意義請參考軟體規格說明。
  註2：YYMMDDHHMM00->年月日時分秒，秒必須為00。
            Ex : 021210110200 表示西元2002年12月10日11點02分
  
  
  函式回傳值說明：

  1.	StartCon(ServerIP,ServerPort,UserID,Passwd,ret_code)：
  	ret_code 說明 -5  Socket Receive資料失敗 -4  Socket Send資料失敗 -3  Socket Connect失敗 -2  Socket Create失敗 -1  WSAStartup失敗 0  帳號/密碼檢查成功 1  帳號/密碼檢查失敗 23  暫時無法檢查帳號/密碼
  2.	SendMsg(MobileNum,Message,ret_code,ret_description)與SendMsg_Order(...)：
  	ret_code ret_description 說明 0 MessageID 傳送成功後，系統回傳的訊息代碼 21 msisdn value error  手機號碼格式或內容錯誤 21 short_msg is empty or too long  簡訊內容為空的或太長 21 send_time format error  預約傳送時間格式錯誤 80 message content > max limit  簡訊內容長度超過160個 3 Message sending failure, try again  系統暫時無法傳送訊息 2 Can not send character  傳送文字到數字型呼叫器 4 Ordered time beyond 48 hours  預約時間超過48小時 -4 socket send error!  Socket Send資料失敗 -5 socket receive error!  Socket Receive資料失敗
  3.	QueryMsg(MobileNum,MessageID,ret_code,ret_description)：
  	ret_code ret_description 說明 10 Successful   訊息已送達對方 11 mobile turn off/mobile out of the scope  手機未開或在受訊範圍外 12 System contains no data   查詢系統無此資料 13 Message can not send to GSM/Pager   訊息無法送達對方 14 System error, try again   系統暫時無法查詢 15 Unkonwn message status   訊息狀態不明 -4 socket send error!  Socket Send資料失敗 -5 socket receive error!  Socket Receive資料失敗
  4.	EndCon()：無回傳值
  5.	其他回傳值說明：
  	回傳數值 回傳字串 內容 20  Server too busy  系統負載過重 21  顯示錯誤部份(interface_type, msg_type, …)  傳送資料格式錯誤 22  Server can not receive data  接收資料錯誤 24  ID/Password has not been checked  帳號/密碼未經驗證 25  Connection number too many  同時連線數過多 27  Permission denied  沒有權限 30  Server shutdown  系統關機

  　

• 其他相關說明：
  
  1. SendMsg( )將簡訊傳送到Socket to Air伺服器，如果成功，則系統回傳一個MessageID
      ，之後可於24小時內，根據此MessageID，使用QueryMsg( )查詢簡訊是否有成功傳
      送至GSM手機或呼叫器中。若沒取得MessageID，則不算發送成功。
  
  2. StartCon( )成功建立連線後，才可使用SendMsg( )和QueryMsg( )，傳送結束後，請記
      得使用EndCon( )結束連線。
  
  3. 如欲一次傳送多筆簡訊，請於StartCon( )成功建立連結後，多次執行SendMsg( )即可。
  
  4. Socket to Air伺服器，同一帳號最多可建立十個Connection。