文档介绍:实时数据平台 C++ 接口函数参考手册- 1- 实时数据平台 C++ 接口函数参考手册第一部分用户编程接口说明一、 C++ 语言用户接口函数类实时数据平台在Alph a计算机OPEN VMS操作系统C++ 编程环境和PC机Visual C++ 编程环境中提供了 C++ 语言用户接口函数(API ),供用户编程访问实时数据平台中的数据库。 C++ 语言用户接口函数全部放在CUserAp i类中,作为CUserAp i类的成员函数。用户建立了 CUserApi 类的实例以后,就可以直接调用 CUserApi 类的成员函数实时数据平台中的数据库。二、函数返回值大部分用户接口函数的返回值用于表示函数执行状态。表示函数执行状态的返回值总是一个整型数,当返回值大于零时表示函数执行正确,当返回值小于或等于零时,表示函数执行失败。返回值的意义见各个函数中的说明。三、 OPEN VMS 操作系统 C++ 编程环境中调用 API 在Alpha 计算机 OPEN VMS 操作系统 C++ 编程环境中,实时数据平台提供了两个头文件和三个目标模块库。文件分别名称为: 两个头文件分别为 ,其中分别包含了函数定义和符号定义。用户程序中如果要调用 API ,必须在程序中用#include 包含这两个头文件。用户程序在编译以后要与实时数据平台提供的两个目标模块库连接。连接命令如下: $clink <用户程序程序名> clink 是编程环境中提供的一个命令,它完成用户的 C++ 程序与连接库的自动连接。(注:为使此命令有郊,用户每次以用户身份进入 Open VMS 操作系统用户目录下之后,首先执行命令‘$***@RTDBLOG ’或将此命令加到用户 LOGIN 命令过程中。) 实时数据平台 C++ 接口函数参考手册- 2- 四、 Windows 95、 Windows NT Visual C++ 编程环境中调用 API Visual C++ 编程环境中,实时数据平台提供了两个头文件、一个引入库和一个动态连接库。文件分别名称为: 两个头文件分别为 ,其中分别包含了函数定义和符号定义。用户程序中如果要调用 API ,必须在程序中用#include 包含这两个头文件。在用户程序工作台(Workspace) 中,在选单 project 下选择 Settings.. ,进入设置对话框,选择Lin k设置,在Object/library Module 。用户程序运行时要保证能找到动态连接库 。可以将 l 放在用户程序的目录下,或者放在 Windows 的system 下。第二部分用户编程接口( 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 。实时数据平台 C++ 接口函数参考手册- 3- count (读) TAG 点个数。 attr (读) 数据库属性,说明确认哪种数据库的点,用下列符号表示: RTDB_ATTR_STANDARD 标准数据库(缺省值); RTDB_ATTR_SIMULATE 仿真数据库。返回值: 指示函数执