“清扬”短信服务器软件 发送短信API接口说明和例子程序

接口说明：
　　北京清扬创新将尝试提供部分可以利用清扬软件的接口api，以方便用户的使用。
　　这里介绍的是利用清扬短信服务器软件发短信的接口。
　　短信服务器软件是一个利用了短信猫(Gsm Modem)来收发短信的软件,并支持繁体、日语等多语言短信的发送，在某些环境下,比如:在隔离网络中,似乎是收发短信的主要选择。
　　北京清扬创新提供了一个qyVDevApi.dll，用此dll可建立和短信服务器的沟通。

API接口介绍
　　int qvdSendSm( void * p0, WCHAR * sm, char * phoneNo, HWND hWnd_notify, int iUsrData );

参数说明:
　　 　　p0,             保留
　　 　　sm,             要发送的短信文本, 字符串
　　 　　phoneNo,        手机号码, 要加区号; 比如: 8613146630221
　　 　　hWnd_notify,    可收发送后通知的窗口句柄
　　 　　iUsrData,       一个用户定义的标识

注意:
1.短信服务器发送短信后,将用WM_COPYDATA的消息发送一个响应包到hWnd_notify, 响应包格式如下: 　　 typedef struct __qvdSmResp_t {
　　 　　int             id;
　　 　　int             iErr;
　　 } QVD_SM_RESP;

2. hWnd_notify不是必需的,如果对响应包不感兴趣,不用传入。

如何使用:
1.硬件：把自备短信猫GSM MODEM接入电脑。选择合适的型号，请参看：如何为清扬即时通信挑选短信猫(GSM MODEM)和测试发送短信。

2.软件：用清扬短信服务器软件控制短信猫发送短信。下载软件，请参看：清扬短信服务器软件快速入门。也有flash视频教程可以更直观地掌握如何使用。

3.软件设置：在利用API向短信服务器发送短信前,要打开菜单[配置]/[个性化策略]里，设置“允许第三方软件发送短信”，（参看下图图示）。同时注意: 此设置必须在管理员权限下才能设置（否则该设置自动变灰）。

4.编程：使用发送短信API接口编译测试。API接口的例子程序，请参看本文章：清扬短信服务器发送短信API接口说明和例子程序，下载例子:qySrc_smDemo，可以编译测试。该例子qySrc_smDemo利用动态装载将dll装入，找到相关函数地址，即可在后面调用。在使用时,注意将dll目录下的qyVDevApi.dll拷在生成的qyVDevSample.exe同一个目录下。

其他说明:
硬件上，如果短信猫gsm modem的波特率不是9600,请在清扬短信服务器软件管理界面的菜单[配置]/[个性化配置]里,重设波特率（baud），（参看下图图示）。

图：清扬短信服务器软件（单机版）：支持API接口的配置

相关主题
“清扬”短信服务器软件
如何挑选短信猫和测试发送短信
清扬短信服务器快速入门
动手建立全新的短信群发业务平台
导入短信群发的手机通信录
电话、短信采购热线和网上在线销售一样不能少