文档介绍:第一部分用户编程接口说明一、C++语言用户接口函数类实时数据平台在Alpha计算机OPENVMS操作系统C++编程环境和PC机VisualC++编程环境中提供了C++语言用户接口函数(API),供用户编程访问实时数据平台中的数据库。C++语言用户接口函数全部放在CUserApi类中,作为CUserApi类的成员函数。用户建立了CUserApi类的实例以后,就可以直接调用CUserApi类的成员函数实时数据平台中的数据库。二、函数返回值大部分用户接口函数的返回值用于表示函数执行状态。表示函数执行状态的返回值总是一个整型数,当返回值大于零时表示函数执行正确,当返回值小于或等于零时,表示函数执行失败。返回值的意义见各个函数中的说明。三、OPENVMS操作系统C++编程环境中调用API在Alpha计算机OPENVMS操作系统C++编程环境中,实时数据平台提供了两个头文件和三个目标模块库。文件分别名称为:,其中分别包含了函数定义和符号定义。用户程序中如果要调用API,必须在程序中用#include包含这两个头文件。用户程序在编译以后要与实时数据平台提供的两个目标模块库连接。连接命令如下:$clink<用户程序程序名>clink是编程环境中提供的一个命令,它完成用户的C++程序与连接库的自动连接。(注:为使此命令有郊,用户每次以用户身份进入OpenVMS操作系统用户目录下之后,首先执行命令‘$***@RTDBLOG’或将此命令加到用户LOGIN命令过程中。)四、Windows95、WindowsNTVisualC++编程环境中调用APIVisualC++编程环境中,实时数据平台提供了两个头文件、一个引入库和一个动态连接库。文件分别名称为:,其中分别包含了函数定义和符号定义。用户程序中如果要调用API,必须在程序中用#include包含这两个头文件。在用户程序工作台(Workspace)中,在选单project下选择Settings..,进入设置对话框,选择Link设置,在Object/。。,或者放在Windows的system下。 第二部分用户编程接口(API)成员函数AckAlarmlongAckAlarm(char*database,longarea,longunit,longattr);AckAlarm函数确认TAG点报警。参数database (读)数据库名,单数据库系统为NULL。area (读)区域号,0表示确认所有区域TAG点报警。unit (读)单元号,0表示确认所有单元TAG点报警。attr (读)数据库属性,说明确认哪种数据库的点,用下列符号表示:RTDB_ATTR_STANDARD 标准数据库(缺省值);RTDB_ATTR_SIMULATE 仿真数据库。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:(函数执行失败原因可根据返回值参阅附录A)AckTagAlarmlongAckTagAlarm(char*database,char*tagName,longcount,longattr)AckTagAlarm函数确认一个或多个TAG点报警。参数database (读)数据库名,单数据库系统为NULL。tagName (读)TAG点名称数组,字符串数组指针。因为仅有PV值有报警数据,这里也可写成:<点名>.PV。count (读)TAG点个数。attr (读)数据库属性,说明确认哪种数据库的点,用下列符号表示: RTDB_ATTR_STANDARD 标准数据库(缺省值); RTDB_ATTR_SIMULATE 仿真数据库。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:(函数执行失败原因可根据返回值参阅附录A)AsciiTimelongAsciiTime(TIME_DESC*bTime,char*sTime)AsciiTime函数将二进制时间转换成ASCII时间。参数bTime (读)二进制时间数据结构。TIME_DESC数据结构格式:typedefstruct{longtime;longflag;//,,}TIME_DESC;其中:time为二进制时