资源描述：
《C接口函数参考手册》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。
1、实时数据平台C++接口函数参考手册第一部分用户编程接口说明c卄语言用户接口函数类实时数据平台在Alpha计算机OPENVMS操作系统C++编程环境和PC机VisualC++编程环境中提供了C++语言用户接口函数(API),供用户编程访问实时数据平台中的数据库。C++语言用户接口函数全:部放在CUserApi类中,作为CUserApi类的成员函数。用户建立了CUserApi类的实例以后，就可以直接调用CUserApi类的成员函数实时数据平台中的数据库。二、函数返回值大部分用户接口函数的返冋值用于表示函数执行状态。表示函数执行状态的返
2、冋值总是-个整型数，当返冋值大于零时表示函数执行正确，当返回值小于或等于零吋，表示函数执行失败。返回值的意义见各个函数中的说明。三、OPENVMS操作系统C++编程环境中调用API在Alpha计算机OPENVMS操作系统C++编程环境中，实时数据平台提供了两个头文件和三个口标模块库。文件分别名称为：userapi.huscrdcf・hviewlib.olbrtdblib.olbbaselib.olb两个头文件分别为userapi.h和userdef.h,其中分别包含了函数定义和符号定义。用户程序中如果要调用API,必须在程序中用#
3、includc包含这两个头文件。用户程序在编译以后要与实时数据平台提供的两个目标模块库连接。连接命令如下：$clink〈用户程序程序名〉clink是编程环境中提供的一个命令，它完成用户的C++程序与连接库的自动连接。(注：为使此命令有郊，用户毎次以用户身份进入OpenVMS操作系统用户目录下之后，首先执行命令'$@RTDBLOG'或将此命令加到用户LOGIN命令过程屮。)从!、Windows95、WindowsNTVisualC++编程环境中调用APIVisualC++编程环境中，实时数据平台提供了两个头文件、一个引入库和一个动态
4、连接库。文件分别名称为：uscrapi・huserdef・hrtdbapi.librdtbapi.dll两个头文件分别为userapi.h和userdef.h,其中分别包含了函数定义和符号定义。用户程序小如果要调用API,必须在程序屮用ttinclude包含这两个头文件。在用户程序工作台（Workspace）中，在选单projectT*选择Settings..,进入设置对话框，选择Link设置，在Object/1ibraryModules下填入rtdbapi.1ibo用户程序运行时要保证能找到动态连接库rdtbapi.dll。可以
5、将rdtbapi.dll放在用户程序的目录下,或者放在Windows的system下。第二部分用户编程接口（API）成员函数AckAlarmlongAckAlarm(char*database,longarea,longunit,longattr);AckAlarm函数确认TAG点报警。（读）数据库名，单数据库系统为NULL。（读）区域号，（读）单元号，（读）数据库属性，参数0表示确认所有区域TAG点报警。0表示确认所有单元TAG点报警。说明确认哪种数据库的点，用下列符号表示:标准数据库（缺省值）；仿真数据库。databasear
6、eaunitattrRTDB_ATTR_STANDARDRTDBATTRSIMULATE返回值：函数执行成功;函数执行失败；指示函数执行状态：不小于1的整数值小于1的整数值注：（函数执行失败原因可根据返回值参阅附录A）AckTagAlarmlongAckTagAlarm(char*database,char*tagName,longcount,longattr)AckTagAlarm函数确认一个或多个TAG点报警。参数databasetagName（读）数据库名，单数据库系统为NULLo（读）TAG点名称数组，字符串数组指针。因为
7、仅有PV值有报countattr示：（读）TAG点个数。（读）数据库属性，说明确认哪种数据库的点，用下列符号表RTDBATTRSTANDARD标准数据库（缺省值）；RTDB_ATTR_S1MULATE仿真数据库。返回值：指示函数执行状态：不小于1的整数值函数执行成功;小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）AsciiTimelongAsciiTime（TIME_DESC*bTime,char*sTime）AsciiTime函数将二进制时间转换成ASCII时间。参数bTime（读）二进制时间数据结构
8、。TIME_DESC数据结构格式：typedefstruet{longtime;longflag;//0.Error,1.Absolute,2.Relative}TIME_DESC;其中:time为二进制时间ffi,flag为二进制时间标志：1表示
