lyfz_repos/经典版源码/旧的后台处理/LYFZMsgManage/DLL-demo/MWDemos/Comdemo/Asp使用说明.txt

本文件包含两部分
第一部份 客服组件的安装
第二部分 组件函数调用说明(ASP)

一、客服组件的安装
1.把MWGateway.dll放到Windows的安装目录，如：C:\Windows\
2.打开“运行”对话框：在“开始”菜单中点击“运行”菜单，打开“运行”对话框
3.注册客服组件
  在“运行”对话框的输入框中输入：regsrv32 "组件dll路径\MWCom.dll"
  其中 客服组件dll路径为 MWCom.dll文件所在的目录全称 如：c:\MW

****************************特别说明****************************
 1.使用Http方式连接到平台，请使用 server1.montnets.com:80
 2.使用Http方式连接到服务器，必须使用所有以"Http"结尾的方法
 3.使用socket4,socket5,http代理连接服务器时候，服务器要设置成 "61.242.89.115"
****************************************************************

二、 组件函数调用说明(ASP)

1、建立连接
Public Function MWConnect(ByVal myip As String, ByVal myport As Integer, _
   ByVal myaccount As String, ByVal mypass As String) As Long
参数1：网关IP(61.242.89.115)
参数2：网关端口号(8018)
参数3：企业短信帐户代码
参数4：企业短信帐户密码
返回值：
  正值: 登陆成功，该值为socket句柄
    -1: 输入参数中，包含有NULL值
    -3: 获取远程主机信息失败,原因:IP解析失败或无效的IP,或网络不通
    -4: socket创建失败
    -5: connect失败
    -6: connect成功,等待平台返回连接确认信息超时
    -7: 接收平台返回登陆验证信息超时
    -8: 错误的用户名或密码


2、重新连接
Public Function MWReConnect() As Long
返回值：
   成功:连接句柄
   失败:-1~-9之间的值
注:在连接成功一次后调用才有效

3、接收用户上行信息
Public Function MWCsGetMsg() As Integer 
返回值：
 成功：收到的信息个数(内容保存在组件的信息队列中)
 失败：-999 网络连接已经中断，请重新连接
     其他值 网络连接超时

4、读取信息队列内容
Public Function MWGetRcvdMsg(ByVal index As Integer) As String
参数index 最大值为1000

客服信息的格式为：
   8,接收日期,接收时间,手机号码,服务号码,*,信息内容
 如：
   8,2005-09-16,10:31:25,1382523**27,555522220844,*,测试上行信息

增值信息的格式为： 
  接收日期,接收时间,手机号码,服务端口,业务代码,短信匹配码,信息内容
 如： 
   2006-05-09,12:23:6,13534***342,91600,0,12145678,测试上行信息

无信息时：返回空字符串或者"接收无信息"

5、单向发送信息
Public Function MWSendMsg(ByVal mobi As String, ByVal note As String) As Integer
参数1：接收方手机号，只能对一个手机进行发送
参数2：信息内容（字符串指针变量，68个字以内，汉字和英文字符均按个数计算）
参数3：提交成功时返回信息编号
返回值：当前状态（整型变量）
 成功: 1
 失败: -1  输入参数中，包含有空值
       -2  手机号码大于15位
    -3,-4  与服务器交互超时
     -999  网络连接已经中断，请重新连接


6、发送客服信息
Public Function MWCsSendMsg(ByVal mobi As String, ByVal note As String,
 ByVal icount As Integer) As Integer
参数1：接收手机；如:"13500000000,13600000000"
参数2：信息内容
参数3：接收手机的个数(不能大于1000)
返回值:
      1 成功
     -1 输入的参数中，包含有NULL值
  -3,-4 与服务器交互超时
    -10 分配堆空间失败
   -999  网络连接已经中断，请重新连接

7.取得信息编号
Public Function MWCsMsgID() As String
返回值：
  发送信息成功: 信息编号
  发送信息不成功:ER,错误编号

8、查询信息条数余额
Public Function MWQueryFee() As Long
返回值：当前可发送信息条数
  成功:可发送信息条数
  失败：-999 网络连接已经中断，请重新连接  

9、查询信息使用条数
Public Function MWQueryUsed() As Long
返回值：已经使用的信息条数
  成功:已经使用的信息条数
  失败：-999 网络连接已经中断，请重新连接  

10、断开连接
Public Sub MWDisConnect()
返回值：无

11、读取客服信息状态报告
Public Function MWCsGetStatus() As Integer 
返回值： 
   成功：收到的状态报告个数(内容保存在组件的状态报告队列中)
   失败：-999 网络连接已经中断，请重新连接
         其他值：网络连接超时

12、读取状态报告队列内容
Public Function MWGetStatRep(ByVal index As Integer) As String
参数index 最大值为1000

有状态报告时返回值格式为：
     6,接收日期,接收时间,短信编号,*,发送状态,错误代码(0D0A)
  其中：发送状态：0--发送成功，1--发送暂缓，2--发送失败
 如：
    6,2005-10-09,14:58:34,1009145815027534,*,0,DELIVRD

无状态报告时：返回空字符串或者 "接收无状态报告"

13、测试连接有效性
Public Function MWTestConn() As Long '测试连接
返回值：
   有效: 1
   无效: 0
   -999: 网络连接已经中断，请重新连接
   
14、设置连接句柄
Public Sub MWSetSocketHandle(ByVal mysock As Integer) 
注: 在设置前请确认此句柄对应连接有效，一般不要使用

15、修改密码
Public Function MWChangePsw(ByVal newpass As String) As Long 
参数：新密码，如：123456
返回值:
      1 成功
     -1 输入的参数中，包含有NULL值
    -2: 密码长度非法
 -3,-4: 与服务器交互超时


**************************************************************************
	 	    		Http方法
**************************************************************************
16、建立连接
Public Function MWConnectHttp(ByVal myip As String, ByVal myport As Integer, _
   ByVal myaccount As String, ByVal mypass As String) As Long
 用法与  MWConnect 相同

17、重新连接
Public Function MWReConnectHttp() As Long
 用法与  MWReConnect 相同

18、修改密码
Public Function MWChangePswHttp(ByVal newpass As String) As Long 
 用法与  MWChangePsw 相同

19、测试连接有效性
Public Function MWTestConn() As Long '测试连接
 用法与  MWCsGetMsg相同

20、读取客服信息状态报告
Public Function MWCsGetStatus() As Integer 
 用法与  MWCsGetMsg相同

21、查询信息条数余额
Public Function MWQueryFee() As Long
 用法与  MWCsGetMsg相同

22、查询信息使用条数
Public Function MWQueryUsed() As Long
 用法与  MWCsGetMsg相同

23、发送客服信息
Public Function MWCsSendMsg(ByVal mobi As String, ByVal note As String,
 ByVal icount As Integer) As Integer

24、接收用户上行信息
Public Function MWCsGetMsgHttp() As Integer 
 用法与  MWCsGetMsg相同

附表1:错误信息编号表.
1----用户登陆不成功,
2----提交格式不正确,
3----用户余额不足,
4----手机号码不正确,
5----计费用户帐号错误,
6----计费用户密码错,
7----账号已经被停用,
8----账号类型不支持该功能,
9----其它错误,
10---企业代码不正确,
11---信息内容超长,
12---不能发送联通号码,
13---操作员权限不够,
14---费率代码不正确,
15---服务器繁忙,
16---企业权限不够,
17---此时间段不允许发送,
18---经销商用户名或密码错,
19---手机列表或规则错误,
21---没有开停户权限,
22---没有转换用户类型的权限,
23---没有修改用户所属经销商的权限,
24---经销商用户名或密码错,
25---操作员登陆名或密码错误,
26---操作员所充值的用户不存在,
27---操作员没有充值商务版的权限,
28---该用户没有转正不能充值,
29---此用户没有权限从此通道发送信息,
30---不能发送移动号码,
31---手机号码(段)非法,
32---用户使用的费率代码错误,
33---非法关键词,
35---不能发送多个手机,
36---不能发送单个手机,
37---单发相同的信息超过流量暂停,
38---经销商权限不够,
40---重复注册,
41---读取上行MO信息太快,
42---读取状态报告太快,
43---超过单个帐号的最大登陆数,
44---该帐号没有扩展子端口权限,
45---信息包编号小于旧编号错误,
46---信息包编号大于旧编号错误,
47---修改密码错误,
48---卡号或密码错误,
99---其它错误,

附表2、打包的手机号码列表中手机号码判断规则:
1。手机号码之间用英文逗号连接，最后结尾不用逗号
2。移动号码判断规则为13400000000～13489999999, 13500000000~13999999999,
   15900000000~15999999999,长度必须11位，必须全为数字
3。联通号码判断规则为13000000000～13399999999,长度必须11位，必须全为数字
4。小灵通号码判断规则为必须118或116开头，必须全为数字，长度大于13位小于15位