1 / 60
文档名称:

2021年C接口函数参考手册.doc

格式:doc   大小:226KB   页数:60页
下载后只包含 1 个 DOC 格式的文档,没有任何的图纸或源代码,查看文件列表

如果您已付费下载过本站文档,您可以点这里二次下载

分享

预览

2021年C接口函数参考手册.doc

上传人:书犹药也 2020/11/4 文件大小:226 KB

下载得到文件列表

2021年C接口函数参考手册.doc

文档介绍

文档介绍:实时数据平台C++接口函数参考手册
第一部分 用户编程接口说明
一、C++语言用户接口函数类
实时数据平台在Alpha计算机OPEN VMS操作系统C++编程环境和PC机Visual C++编程环境中提供了C++语言用户接口函数(API),供用户编程访问实时数据平台中数据库。
C++语言用户接口函数全部放在CUserApi类中,作为CUserApi类组员函数。用户建立了CUserApi类实例以后,就能够直接调用CUserApi类组员函数实时数据平台中数据库。
二、函数返回值
大部分用户接口函数返回值用于表示函数实施状态。表示函数实施状态返回值总是一个整型数,当返回值大于零时表示函数实施正确,当返回值小于或等于零时,表示函数实施失败。返回值意义见各个函数中说明。
三、OPEN VMS操作系统C++编程环境中调用API
在Alpha计算机OPEN VMS操作系统C++编程环境中,实时数据平台提供了两个头文件和三个目标模块库。文件分别名称为:





,其中分别包含了函数定义和符号定义。用户程序中假如要调用API,必需在程序中用#include包含这两个头文件。
用户程序在编译以后要和实时数据平台提供两个目标模块库连接。连接命令以下:
$clink <用户程序程序名>
clink是编程环境中提供一个命令,它完成用户C++程序和连接库自动连接。
(注:为使此命令有郊,用户每次以用户身份进入Open VMS操作系统用户目录下以后,首先实施命令‘$ ***@RTDBLOG’或将此命令加到用户
LOGIN命令过程中。)
四、Windows 95、Windows NT Visual C++编程环境中调用API
Visual C++编程环境中,实时数据平台提供了两个头文件、一个引入库和一个动态连接库。文件分别名称为:




,其中分别包含了函数定义和符号定义。用户程序中假如要调用API,必需在程序中用#include包含这两个头文件。
在用户程序工作台(Workspace)中,在选单project下选择Settings..,进入设置对话框,选择Link设置,在Object/library 。
。,或放在Windowssystem下。

第二部分 用户编程接口(API)组员函数
AckAlarm
long AckAlarm(char* database, long area, long unit, long attr) ;
AckAlarm函数确定TAG点报警。
参 数
database (读) 数据库名,单数据库系统为NULL。
area (读) 区域号,0表示确定全部区域TAG点报警。
unit (读) 单元号,0表示确定全部单元TAG点报警。
attr (读) 数据库属性,说明确定哪种数据库点,用下列符号表示:
RTDB_ATTR_STANDARD 标准数据库(缺省值);
RTDB_ATTR_SIMULATE 仿真数据库。
返回值:
指示函数实施状态:
大于1整数值 函数实施成功;
小于1整数值 函数实施失败;
注:(函数实施失败原因可依据返回值参阅附录A)
AckTagAlarm
long AckTagAlarm (char* database, char* tagName, long count, long attr)
AckTagAlarm函数确定一个或多个TAG点报警。
参 数
database (读) 数据库名,单数据库系统为NULL。
tagName (读)TAG点名称数组,字符串数组指针。因为仅有PV值有报警数据,这 里也可写成: <点名>.PV。
count (读) TAG点个数。
attr (读) 数据库属性,说明确定哪种数据库点,用下列符号表示:
RTDB_ATTR_STANDARD 标准数据库(缺省值);
RTDB_ATTR_SIMULATE 仿真数据库。
返回值:
指示函数实施状态:
大于1整数值 函数实施成功;
小于1整数值 函数实施失败;
注:(函数实施