/////////////////////////////////////////////
//
//
//TFTOP-SMS短信二次開發頭文件
//版本2.0
//
/
//在您的VC工程中請包含此頭文件
//
//版權所有
//
//
/////////////////////////////////////////////
//使用說明：我們的短信模塊提供兩種操作接口函數，線程函數接口和非線程函數接口，
//1，線程函數接口的工作原理：
//是用戶在程序的開始部分啟動我們的短信線程,調用函數StartSMSThread，在程序的結束部分結束我們的
//短信線程,調用函數EndSMSThread，當短信線程成功開始后，我們的線程自動的從我們線程的短信發送隊
//列中取出短信進行發送或者接收短信并放到接收短信隊列中，您要做的工作就是使用函數AddSMSToPool把
//要發送的短信放到我們線程的短信發送隊列中，要得到發回的短信，調用GetSMSFromPool，當此函數返回
//值為TRUE時，意味著有短信，短信的相關信息放在函數的參數里。
//2，非線程函數接口的工作原理
//用戶也要在您程序的開始部分執行StartSMS，結束時執行EndSMS函數，要發送短信執行SendASMS
//接收使用GetASMS
//3，公共函數接口
//函數CheckDevice可以檢測設備是否工作正常，正常返回TRUE,否則返回FALSE
//函數SMSSettings短信參數設置，設置串口通訊參數和短信中心號碼
//函數SMSMode用來設置短信發送模式，如果發純英文用模式1，如果中文或者中英文混合用模式0
//函數GetSMSDeviceID得到短信設備的唯一ID號碼



/********************************************
* 函數功能：啟動短信收發引擎，在所有短信函數之前調用，并且只能一次。
* 不需要傳遞參數，調用此函數開始進入短信收發循環線程。
* 返回: 成功返回TRUE,否則FALSE;
*********************************************/
BOOL _stdcall StartSMSThread(); 

/********************************************
* 函數功能：將要發送的短信加到短信發送隊列中進行排隊發送
* strNumber:短信發往的手機號碼比如"13910424818"
* strContent:要發送的短信內容，比如"歡迎您使用我們的產品!"
* 返回: 沒有返回值，如果要知道短信是否發送成功，請查詢最后的返回代碼，用函數GetSMSLastErrorCode();
*********************************************/
void _stdcall AddSMSToPool(char* strNumber,char* strContent);


/********************************************
* 函數功能：從接受到的短信隊列中讀出一條短信
* strNumber:收到短信的手機號碼比如"13910424818"
* strTime:短信收到的時間
* strContent:短信內容
* 返回: TRUE則收到短信，否則沒有收到短信。
*********************************************/
BOOL _stdcall GetSMSFromPool(char* strNumber,char* strTime,char* strContent);


/********************************************
* 函數功能：結束短信引擎，在所有短信函數之后調用，并且只能一次，一般來說，程序退出時調用。
* 不需要傳遞參數，調用此函數結束短信收發循環線程。
* 返回: 沒有返回值;
*********************************************/
void _stdcall EndSMSThread(); 


///////////////////////////////////////////////////////////////////////
//以下函數是非線程調用方式
/////////////////////////////////////////////////////////////////////////

/********************************************
* 函數功能：短信發送初始化
* 不需要傳遞參數，調用此函數后就可以調用收發短信函數收發短信了
* 返回: 初始化成功返回TRUE,否則FALSE;
*********************************************/
BOOL _stdcall StartSMS(); 

/********************************************
* 函數功能：發送一條短信
* strNumber:短信發往的手機號碼比如"13910424818"
* strContent:要發送的短信內容，比如"歡迎您使用我們的產品!"
* 返回: 發送成功返回TRUE,否則FALSE
*********************************************/
BOOL _stdcall SendASMS(char* strNumber,char* strContent);

/********************************************
* 函數功能：接收一條短信
* SMSIndex:SIM卡中短信的編號，比如1，2，等
* strNumber:短信接受的手機號碼比如"13910424818"
* strTime	:短信接受時間
* strContent:要接受的短信內容，比如"歡迎您使用我們的產品!"
* 返回: 如果接受成功返回TRUE，則可以從函數里取出相應參數,否則FALSE
*********************************************/
BOOL _stdcall ReceiveASMS(int SMSIndex,char* strNumber,char* strTime,char* strContent); 

/********************************************
* 函數功能：結束短信，在所有短信函數之后調用，并且只能一次，一般來說，程序退出時調用。
* 不需要傳遞參數，調用此函數結束短信收發。
* 返回: 沒有返回值;
*********************************************/
void _stdcall EndSMS();






///////////////////////////////////////////////////////////////////////
//以下是公共函數，非線程或者線程都可以調用，用來配置參數和測試設備
/////////////////////////////////////////////////////////////////////////

/********************************************
* 函數功能：檢測設備工作是否正常
* 不需要傳遞參數，調用此函數自動彈出參數設置對話框
* 返回: 正常返回TRUE,否則返回FALSE
*********************************************/
BOOL _stdcall CheckDevice();

/********************************************
* 函數功能：短信發送模式
* iType =0為PDU模式，可以發送中文或者中英文混合，長度不超過70（如果是中英文混合，英文字符也按一個漢字計算）
*		=1為文本模式，只能發送純英文，長度為不超過160個字符
* 返回: 正常返回TRUE,否則返回FALSE
*********************************************/
void _stdcall SMSMode(int iType);

/********************************************
* 函數功能：短信參數設置，設置串口通訊參數和短信中心號碼
* 不需要傳遞參數，調用此函數自動彈出參數設置對話框
* 返回: 沒有返回值
*********************************************/
void _stdcall SMSSettings(); 

/********************************************
* 函數功能：得到短信設備的唯一ID號碼
* strDeviceID:如果函數調用成功，次變量保存的就是設備的唯一ID
* 返回: TRUE或者FALSE
*********************************************/

//得到短信設備的唯一ID號碼
BOOL _stdcall GetSMSDeviceID(char* strDeviceID);