短信dll_API使用手册

格式：doc
大小：280.50 KB
文档页数：18

本文档及其所含信息为内部保密材料,由北京神州数码思特奇信息技术股份有限公司拥有

C API使用手册

（Vx.x）

北京神州数码思特奇信息技术股份有限公司

二〇一三年四月集成测试用例

神州数码思特奇信息技术股份有限公司地址：北京市海淀区上地九街9号数码科技广场二层(100085)

电话 (Tel) ：(010) 58856600 传真 (Fax)：(010) 62969630

第2 页，共18 页文档信息

文档名称 API使用手册

电子文档 API使用手册.doc/Microsoft WORD 2003

文件状态 ■ 草稿 □ 正式发布 □ 正在修改

编写人 AC_TEST 日期年月日

校对人日期年月日

审核人日期年月日

批准人日期年月日

变更记录

变更序号变更原因变更页码变更前版本号变更后版本号更改人批准人生效日期备注

集成测试用例

神州数码思特奇信息技术股份有限公司地址：北京市海淀区上地九街9号数码科技广场二层(100085)

电话 (Tel) ：(010) 58856600 传真 (Fax)：(010) 62969630

第3 页，共18 页集成测试用例

神州数码思特奇信息技术股份有限公司地址：北京市海淀区上地九街9号数码科技广场二层(100085)

电话 (Tel) ：(010) 58856600 传真 (Fax)：(010) 62969630

第4 页，共18 页 1 引言

1.1 编写目的

【方便第三方用户方便的使用API接口】

1.2 术语定义

【列出测试用例中所用到的专门术语的定义和缩写词的原意。】

1.3 参考资料

【列出有关资料的作者、标题、编号、发表日期、出版单位或资料来源。】集成测试用例

神州数码思特奇信息技术股份有限公司地址：北京市海淀区上地九街9号数码科技广场二层(100085)

电话 (Tel) ：(010) 58856600 传真 (Fax)：(010) 62969630

第5 页，共18 页 2 短信API接口函数说明

2.1 建立连接，并创建收发线程。

2.1.1 函数定义:

int App_Bind( );

2.1.2 输入/输出函数

输入参数: NULL

返回值 : 1 成功;

2 socket连接已经存在

-3 打开文件失败;

-2 bind失败

建立连接的参数 IP地址用户名密码端口从配置信息文件(mms_cfg.ini)中获取

2.1.3 函数功能说明

建立与服务器的连接，创建收短信/发短信线程。收短信线程处理为：从服务器中取信息放入到收循环队列中。发短信线程处理为：从发循环队列中取短信下发到用户。同时发送链路检测包维持链路的连接。集成测试用例

神州数码思特奇信息技术股份有限公司地址：北京市海淀区上地九街9号数码科技广场二层(100085)

电话 (Tel) ：(010) 58856600 传真 (Fax)：(010) 62969630

第6 页，共18 页 2.1.4 过程流程图

开始与MAS建立连接创建线程从循环队列中获取信息中发送到用户从服务器中获取用户上行的信息.状态报告的话入日志文件成功发收结束线程,释放内存

2.1.5 异常处理:

对出现的错误异常,将以日志输出的方式记录在error_sms_time文件中,

对出现的警告异常,将以日志输出的方式记录在warn_sms_time文件中,

日志文件以天为单位产生.

2.2 断开连接

2.2.1 函数声明:

int App_Unbind() 集成测试用例

神州数码思特奇信息技术股份有限公司地址：北京市海淀区上地九街9号数码科技广场二层(100085)

电话 (Tel) ：(010) 58856600 传真 (Fax)：(010) 62969630

第7 页，共18 页 2.2.2 输入/输出函数

输入值: NULL;

返回值:

>0 成功;

1 断开连接之前socket已经关闭

-1 写socket数据失败

-2 断开连接失败

2.2.3 函数功能说明

断开与服务器的连接

2.2.4 异常处理

与服务器连接失败的异常,将以日志文件的方式记录在warn_sms_time日志文件中

2.3 发送短信

2.3.1 函数定义:

int App_Submit(char *Service_Id,char *Dest_terminal_Id,char

*src_id,char *content)

2.3.2 输入/输出参数

App_Submit 属性

输入参数名称类型说明

service_id Char [8] 内部业务代码集成测试用例

神州数码思特奇信息技术股份有限公司地址：北京市海淀区上地九街9号数码科技广场二层(100085)

电话 (Tel) ：(010) 58856600 传真 (Fax)：(010) 62969630

第8 页，共18 页 content Char [] 短信内容

dest_terminal_id Char [32] 目的号码

Src_id Char [21] 源号码(基本号码+子号码)

返回值 >0 成功 -1 普通短信失败

-2 长短信失败

2.3.3 函数功能说明

用户下发的短信首先入到发的循环队列中,发短信线程不停的扫描发送队列,如果发现队列中插入了数据,则下发到MAS服务器.

长短信条数<=10条,内容不超过1400个字符.

2.3.4 异常处理

对出现的错误异常,将以日志输出的方式记录在error_sms_time文件中,

对出现的警告异常,将以日志输出的方式记录在warn_sms_time文件中,

日志文件以天的单位产生.

2.4 接收短信

2.4.1 函数声明:

int App_Deliver(char *Src_Id,char *Dest_Id,char Msg_Content[1024])

2.4.2 输入/输出参数

输入参数:

App_Deliver 属性

输入参数名称类型说明

Msg_Content Char [1024] 短信内容

Dest_Id Char [32] 目的号码集成测试用例

神州数码思特奇信息技术股份有限公司地址：北京市海淀区上地九街9号数码科技广场二层(100085)

电话 (Tel) ：(010) 58856600 传真 (Fax)：(010) 62969630

第9 页，共18 页 Src_Id Char [21] 源号码(基本号码+子号码)

返回值 =0 成功

=-401 状态报告还没有上来

输出参数: 返回用户上行信息的字符指针:

前32个字节为用户上行号码:

接着21个字节为用户上行手机号

后面1024个字节为用户上行的短信内容

2.4.3 函数功能说明:

接收用户上行的短信信息

2.4.4 异常处理

对出现的错误异常,将以日志输出的方式记录在error_sms_time文件中,

对出现的警告异常,将以日志输出的方式记录在warn_sms_time文件中,

日志文件以天的单位产生.

2.5 接收状态报告

2.5.1 函数声明:

int App_report(char *msgid,char *resultp)

2.5.2 输入/输出参数

输入参数: msgid : 更网关返回的ID对应集成测试用例

神州数码思特奇信息技术股份有限公司地址：北京市海淀区上地九街9号数码科技广场二层(100085)

电话 (Tel) ：(010) 58856600 传真 (Fax)：(010) 62969630

第10 页，共18 页 resultp: 短信中心返回的状态报告()

输出参数: 返回用户上行状态报告的字符指针:

前16个字节为用户下行状态报告ID:

接着8个字节为用户下行状态报告状态

后面4个字节为标志(1.成功.0.失败)

返回值: 长度大于10为有下行状态报告过来,否则没状态报告

2.5.3 函数功能说明:

接收用户下行的状态报告

集成测试用例

神州数码思特奇信息技术股份有限公司地址：北京市海淀区上地九街9号数码科技广场二层(100085)

电话 (Tel) ：(010) 58856600 传真 (Fax)：(010) 62969630

第11 页，共18 页 3 API使用配置说明:

3.1 界面配置

a. 配置下行通道

选择系统管理—业务管理—短信彩信管理, 配置下发短信业务.(如果存在短信业务,测试的时候可直接参考短信群发业务)

b. 配置第3方接入

选择系统管理—设备管理—应用接入管理:添加一条记录

Eg:

用户名和密码必需是小于,等于6位的数字

MAC地址和IP地址输入你本机的IP地址就可以

利用HOOKAPI拦截文件操作

利⽤HOOKAPI拦截⽂件操作

先读下HookAPI 使⽤⽂档:

功能简介

HookAPI 是⼀个截获Windows 32位API函数的开发包，它可以在Windows调⽤某个API函数的时候，先调⽤⾃⼰编写的函数，从⽽实现特殊的功能。

HookAPI同样也适⽤于截获⽤户⾃⼰编写的DLL⽂件中的输出函数。

1.5系统特点：

1）⾃⼰编写的替代函数的参数形式和原API函数完全⼀样，⽅便了Delphi和VB⽤户的使⽤。

2）实时截获所有新建⽴的进程，即进程建⽴后马上安装钩⼦，⽽不是采⽤定时扫描进程的⽅法

3）由于不采⽤定时扫描进程的⽅法，所以系统资源消耗少，基本上看不到消耗CPU资源。

4）新建⽴的InstDLL动态库，减少了⽤户调⽤HookAPI的代码。

运⾏和开发平台为Windows NT/2000/9x/XP

包含的⽂件列表：

【EXE⽬录】：调⽤InstHook.dll来安装HookAPI的执⾏程序

【InstHook⽬录】：安装HookAPI的DLL程序

【dll⽬录】：NT/2000/XP/XP下截获32位API函数的DLL程序

【HOOKAPI9x.dll】：Win9x下截获32位API函数的DLL程序

【EXE⽬录】：HookAPI.exe的源码

【HOOKSOCKET⽬录】：截获Socket函数的mydll例⼦

【HOOKREG⽬录】：截获注册表函数的mydll例⼦

【HOOKFILE⽬录】：截获⽂件存取的mydll例⼦

【HOOKFILE9x⽬录】：win9x下的截获⽂件存取的mydll_9x例⼦

【HookFile_Delphi⽬录】：截获⽂件存取的Delphi下的mydll的例⼦

【HookSocket_Delphi⽬录】：截取Socket函数的Delphi下的mydll的例⼦

使⽤：⽤户编写要截获的API函数相对应的⾃⼰的实现函数，编译成mydll.dll，同时在⾃⼰的程序中调⽤InstHook.dll中的安装/卸载函数就可以实现⾃⼰的截

C#_调用win32的API函数--user32.dll实现窗体的多显示效果(四周扩展,中间缩小,折叠显示,淡入淡出效果)

Win32的API函数是微软自己的东西，可以直接在C#中直接调用，在做WinForm时还是很有帮助的。有时候我们之直接调用Win32 的API，可以很高效的实现想要的效果。

代码

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.Runtime.InteropServices;

namespace WindowsAPI

{

class CSharp_Win32Api

{

#region User32.dll 函数

///

/// 该函数检索一指定窗口的客户区域或整个屏幕的显示设备上下文环境的句柄，以后可以在GDI函数中使用该句柄来在设备上下文环境中绘图。hWnd：设备上下文环境被检索的窗口的句柄

///

[DllImport("user32.dll", CharSet = CharSet.Auto)]

public static extern IntPtr GetDC(IntPtr hWnd);

///

/// 函数释放设备上下文环境（DC）供其他应用程序使用。

///

public static extern int ReleaseDC(IntPtr hWnd, IntPtr hDC);

///

/// 该函数返回桌面窗口的句柄。桌面窗口覆盖整个屏幕。

///

static public extern IntPtr GetDesktopWindow();

///

/// 该函数设置指定窗口的显示状态。

python 远程调用windowsapi的方法

远程调用Windows API的方法可以通过使用Python的`ctypes`标准库来实现。`ctypes`允许我们在Python中调用动态链接库（DLL）中的函数，并通过使用Windows API来执行各种任务，如文件操作、系统管理和网络通信等。

要远程调用Windows API的方法，首先需要确定要调用的API函数所在的DLL。然后，我们可以使用`ctypes`来加载该DLL并获取函数的引用。接下来，可以使用获取的函数引用来调用相应的API函数，并传递所需的参数。

以下是一个简单的示例，演示如何远程调用Windows API函数`GetWindowText`来获取指定窗口句柄的标题：

```python

import ctypes

user32 = er32 # 加载user32.dll

# 定义GetWindowText函数的参数类型

user32.GetWindowTextW.argtypes = [ctypes.c_void_p, ctypes.c_wchar_p,

ctypes.c_int]

# 定义GetWindowText函数的返回类型

user32.GetWindowTextW.restype = ctypes.c_int

# 调用GetWindowText函数获取窗口标题

hwnd = 12345 # 替换为要获取标题的窗口句柄

buffer_size = 256

buffer = ctypes.create_unicode_buffer(buffer_size) user32.GetWindowTextW(hwnd, buffer, buffer_size)

# 打印窗口标题

print(buffer.value)

```

在上面的示例中，我们首先加载了`user32.dll`，然后使用`er32`获取了`user32.dll`中的函数引用。接下来，我们定义了`GetWindowTextW`函数的参数类型和返回类型，并使用`ctypes.create_unicode_buffer`创建了一个缓冲区来存储窗口标题。最后，我们使用获取的函数引用来调用`GetWindowTextW`函数，并将窗口句柄、缓冲区和缓冲区大小作为参数传递。

基于CMPP的智能短信应用系统的设计与实现

李庆

【摘要】简述了短信服务终端和中国移动通讯短消息协议CMPP的基本原理,并根据其基本原理,应用短信终端,提出了开发一种基于CMPP协议的智能短信应用系统的设计思路,并根据该思路分析了智能短信应用系统中的关键问题——短信收发程序的设计,并结合实际案例应用DELPHI 7.0给出了问题的实现方法和核心技术,最终系统能够完全满足实际项目应用.

【期刊名称】《智能计算机与应用》

【年(卷),期】2011(001)006

【总页数】3页(P23-24,27)

【关键词】中国移动通讯短消息协议(CMPP);短信终端;手机短信;DELPHI

【作者】李庆

【作者单位】中国联通金昌市分公司,甘肃金昌737100

【正文语种】中文

【中图分类】TP399

0 引言

当前，短信服务早已融入人们的日常生活，并成为了人们通信、交流与联络的常用手段，短信应用范围也逐步由通用服务向企业领域扩展。面向企业的短信业务作为其应用的一个重要组成部分，已越来越受到市场的关注。此业务已经介入到企业办公、银证、交通、教育、社保等领域，正被越来越多的企事业单位及政府机关所重视，逐渐成为其应用潮流，并日益成为行业应用密不可分的一部分。无论从技术还是市场发展的角度来看，在当今世界信息交流领域，短信已经成为继Internet之后的最主要的技术之一，而智能短信应用系统的设计开发也已成为当前移动增值业务的热点。基于中国移动点对点协议CMPP(China Mobile Peer to Peer)[1]，利用高级语言编写短信收发和管理程序，调用短信服务终端（如短信猫）的动态链接库来实现短信收发，则是一种高效、便捷、可行的系统实现方法。

1 智能短信应用系统的构成和功能

智能短信应用系统包含硬件和软件两部分。硬件主要由短信终端（短信猫）、射频天线等构成，支持SIM卡、STK卡、UIM卡，与计算机系统采用RS-232接口或USB数据线接口连接，带多路无线模块实现支持EGSM900、GSM1800双频段短信的接收和发送功能。软件主要由发送/接收模块和数据库管理模块两部分构成，分别实现全网短信单发，群发，接收等功能和客户、短语、短信数据库的管理功能，此外还可根据需求进一步扩展附加功能如手机号码查询，号码生成，定时提醒工具等，用户可自行控制系统使用，具有较大灵活性、自主性。系统的核心在软件部分，主要功能包含：

下载提示

1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。

短信dll_API使用手册

合集下载

利用HOOKAPI拦截文件操作

C#_调用win32的API函数--user32.dll实现窗体的多显示效果(四周扩展,中间缩小,折叠显示,淡入淡出效果)

python 远程调用windowsapi的方法

基于CMPP的智能短信应用系统的设计与实现

文档推荐

最新文档