tftopsms.h

介绍了VC环境下发送短信的源码

/////////////////////////////////////////////
//
//
//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);