短信控件使用说明
次控件配送产品，没有任何技术支持，需要朋友可以联系客服给您发一份到您的邮箱里去压缩包里有VC6例程。遇到问题可以在本站上发帖子求助网友。
一、
控件支持短信设备类型
本控件适用于西门子、爱立信、诺基亚（8310以后）等手机，以及标准工业Gsm Modem（如WaveCom、FlatCom、西门子等）。
二、
短信控件使用特性
1、异步操作方式。设备连接和短信发送均采用异步方式，即容器程序调用连接函数或发送函数后立即返回。
2、内部包含操作池。控将执行结果以事件的形式通知容器程序。控件可以同时接受容器程序较多的操作请求，控件将这些操作请求放到一个操作队列池中，控件依次逐个执行该操作队列，并将执行结果以事件的形式通知容器程序。如果控件操作池为空，则对外表现为“空闲”状态，否则为“忙”状态。根据这个特性，容器程序可以连续提交多个短信发送请求；在一个程序中使用多个短信控件（即同时连接多个GSM Modem设备，每个控件控制一个GSM Modem设备）时，如果要发送一条短信程序可优先选择一个处于“空闲”状态的短信控件发送。
三、
短信控件使用接口（未描述接口函数在本版本控件中不使用）
3.1接口方法
接口方法一：
|
函数名
|
long SetModemType(short
nType);
|
|
函数描述
|
设置短信设备类型。
|
|
参数描述
|
nType
|
0为手机设备，1为工业GSM Modem。
|
|
返回值
|
忽略（供扩展使用）。
|
接口方法二：
|
函数名
|
long ConnectModem(LPCTSTR
strComName, long nComRate, long nSoftID);
|
|
函数描述
|
连接短信设备。
|
|
参数描述
|
strComName
|
串口标识。如：“COM1”、“COM2”等。
|
|
nComRate
|
西门子手机为19200，工业gsm modem常为9600。
|
|
nSoftID
|
不使用，可为任意值。----供其他版本用的。
|
|
返回值
|
1为已打开串口，正在连接；-1为打开串口失败（或被占用或无此串口）。
|
接口方法三：
|
函数名
|
long DisconnectModem();
|
|
函数描述
|
断开与设备的连接。
|
|
参数描述
|
无
|
无。
|
接口方法四：
|
函数名
|
long
SendSms(LPCTSTR strPhoneNumber, LPCTSTR strSmsContent, long nSmsIndex);
|
|
函数描述
|
发送短消息。
|
|
参数描述
|
strPhoneNumber
|
短信接收号码
|
|
strSmsContent
|
短消息内容
|
|
nSmsIndex
|
短消息标识号（自己填写，用于群发时返回结果的标识）
|
|
返回值
|
1为已经加入短信发送列表。否则未成功加入短信发送列表（如短信接收号码为空的情况）。
|
接口方法五：
|
函数名
|
long SetRecvFlag(BOOL
bRecvFlag);
|
|
函数描述
|
设置设备是否处于允许接收短信的状态。
|
|
参数描述
|
bRecvStatus
|
TRUE为允许（默认），FALSE为不允许。
|
接口方法六：
|
函数名
|
long SetSendFlag(BOOL
bSendFlag);
|
|
函数描述
|
设置设备是否处于允许发送短信的状态。
|
|
参数描述
|
bSendStatus
|
TRUE为允许（默认），FALSE为不允许。
|
接口方法七：
|
函数名
|
BOOL IsConnected();
|
|
函数描述
|
取得设备的当前连接状态。
|
|
返回值
|
TRUE为连接状态，FALSE为断开状态。
|
接口方法八：
|
函数名
|
long IsConnectting();
|
|
函数描述
|
取得当前状态是否处于正在连接设备过程中。
|
|
返回值
|
1为正处于连接过程中，0为不处于连接过程中。
|
接口方法九：
|
函数名
|
BOOL IsFreeStatus();
|
|
函数描述
|
取得当前设备的工作状态，看设备是出于正在执行操作还是空闲状态（不管忙或空闲，均可调用SendSms发送短信。但是若设备处于忙状态，设备要处理完当前事务后，才开始对提交短信进行实际发送。该函数主要用于一机多gsm modem时作负载平衡使用）。
|
|
返回值
|
TRUE为空闲状态，FALSE为正在执行操作的忙状态。
|
接口方法十：
|
函数名
|
int GetTaskCount();
|
|
函数描述
|
获得操作池中待处理的任务总数。
|
|
返回值
|
待处理的任务总数。
|
接口方法十一：
|
函数名
|
void
SetSmsServerNumber(BSTR strNumber);
|
|
函数描述
|
设置服务中心号码
|
|
参数描述
|
strNumber
|
要设置的短信中心号码（并不需要每次启动程序都设置，对新买SIM卡设置一次就行了）。
|
接口方法十二：
|
函数名
|
void
SetSendRate(short nSendFreeTime)
|
|
函数描述
|
设置短信发送速度。
|
|
参数描述
|
nSendFreeTime
|
| 
