c++接口函数参考手册 53页

实时数据平台C++接口函数参考手册实时数据平台C++接口函数参考手册第一部分用户编程接口说明一、C++语言用户接口函数类实时数据平台在Alpha计算机OPENVMS操作系统C++编程环境和PC机VisualC++编程环境中提供了C++语言用户接口函数（API），供用户编程访问实时数据平台中的数据库。C++语言用户接口函数全部放在CUserApi类中，作为CUserApi类的成员函数。用户建立了CUserApi类的实例以后，就可以直接调用CUserApi类的成员函数实时数据平台中的数据库。二、函数返回值大部分用户接口函数的返回值用于表示函数执行状态。表示函数执行状态的返回值总是一个整型数，当返回值大于零时表示函数执行正确，当返回值小于或等于零时，表示函数执行失败。返回值的意义见各个函数中的说明。三、OPENVMS操作系统C++编程环境中调用API在Alpha计算机OPENVMS操作系统C++编程环境中，实时数据平台提供了两个头文件和三个目标模块库。文件分别名称为：userapi.huserdef.hviewlib.olbrtdblib.olbbaselib.olb两个头文件分别为userapi.h和userdef.h，其中分别包含了函数定义和符号定义。用户程序中如果要调用API，必须在程序中用#include包含这两个头文件。用户程序在编译以后要与实时数据平台提供的两个目标模块库连接。连接命令如下：$clink<用户程序程序名>clink是编程环境中提供的一个命令，它完成用户的C++程序与连接库的自动连接。（注：为使此命令有郊，用户每次以用户身份进入OpenVMS操作系统用户目录下之后，首先执行命令‘$@RTDBLOG’或将此命令加到用户LOGIN命令过程中。）－53－n实时数据平台C++接口函数参考手册四、Windows95、WindowsNTVisualC++编程环境中调用APIVisualC++编程环境中，实时数据平台提供了两个头文件、一个引入库和一个动态连接库。文件分别名称为：userapi.huserdef.hrtdbapi.librdtbapi.dll两个头文件分别为userapi.h和userdef.h，其中分别包含了函数定义和符号定义。用户程序中如果要调用API，必须在程序中用#include包含这两个头文件。在用户程序工作台(Workspace)中，在选单project下选择Settings..，进入设置对话框，选择Link设置，在Object/libraryModules下填入rtdbapi.lib。用户程序运行时要保证能找到动态连接库rdtbapi.dll。可以将rdtbapi.dll放在用户程序的目录下，或者放在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。－53－n实时数据平台C++接口函数参考手册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;//0.Error,1.Absolute,2.Relative}TIME_DESC;其中：time为二进制时间值，flag为二进制时间标志：1表示绝对时间，2表示相对时间，0表示错误。sTime（写）ASCII时间字符串。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）BinaryTimelongBinaryTime(char*sTime,TIME_DESC*bTime)BinaryTime函数将ASCII时间转换成二进制时间。参数sTime（读）ASCII时间字符串。bTime（写）二进制时间数据结构。TIME_DESC数据结构格式：typedefstruct{longtime;longflag;//0.Error,1.Absolute,2.Relative}TIME_DESC;其中：time为二进制时间值，flag为二进制时间标志：1表示绝对时间，2－53－n实时数据平台C++接口函数参考手册表示相对时间，0表示错误。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）CommitlongCommit(longviewID);Commit函数向实时数据平台提交实时数据视图中的数据。参数viewID（读）实时数据视图标识。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）CreateAlarmViewlongCreateAlarmView(long&viewID,char*database,longarea,longunit,longviewAttr,longcount)CreateAlarmView函数建立报警记录视图。参数viewID（写）报警记录视图标识。database（读）数据库名，单数据库系统为NULL。area（读）区域号，0表示所有区域。unit（读）单元号，0表示所有单元。viewAttr（读）视图属性，用下列符号表示：VIEW_ATTR_STATIC静态视图（缺省值)；VIEW_ATTR_ACTIVE动态视图；VIEW_ATTR_STANDARD标准视图，数据来自系统数据库（缺省值)；VIEW_ATTR_SIMULATE仿真视图，数据来自仿真数据库。count(读)视图报警中记录个数。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）CreateDataViewlongCreateDataView(long&viewID,char*database,longviewAttr,char*dataDesc,longcount)－53－n实时数据平台C++接口函数参考手册CreateDataView函数建立实时数据视图。参数viewID（写）实时数据视图标识。database(读)数据库名，单数据库系统为NULL。viewAttr(读)视图属性，用下列符号表示：VIEW_ATTR_READONLY只读视图（缺省值)；VIEW_ATTR_WRITE可写视图；VIEW_ATTR_STATIC静态视图（缺省值)；VIEW_ATTR_ACTIVE动态视图；VIEW_ATTR_STANDARD标准视图，数据来自系统数据库（缺省值)；VIEW_ATTR_SIMULATE仿真视图，数据来自仿真数据库。dataDesc(读)视图数据TAG点参数描述表，字符串数组指针。数组中元素均为64字节的字符串，每个元素表示一个TAG点参数的描述，TAG点参数的描述为：<点名>.<参数名>.<细目名>。count(读)点参数描述表中点参数个数。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明如果TAG点参数描述表中某TAG点仅描述为<点名>，则在建视图时，会按隐式规则将此TAG点的所有参数的PV项自动建成。CreateDayStaViewlongCreateDayStaView(long&viewID,char*database,longviewAttr,char*dataDesc,longtagCount,char*endTime,longcount);CreateDayStaView函数建立日统计数据视图。参数viewID（写）日统计数据视图标识。database(读)数据库名，单数据库系统为NULL。viewAttr(读)视图属性，用下列符号表示：VIEW_ATTR_STANDARD标准视图，数据来自系统数据库（缺省值)；VIEW_ATTR_SIMULATE仿真视图，数据来自仿真数据库。dataDesc(读)视图数据TAG点描述表，字符串数组指针。数组中元素均为64字节的字符串，每个元素表示一个TAG点名称。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。tagCount(读)视图中TAG点个数。endTime(读)视图统计数据结束时间，视图数据结束时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示视图数据结束时间为某一确定时间；－53－n实时数据平台C++接口函数参考手册1、当前时间，用NULL时表示；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示视图数据结束时间为当前时间向前减去所表示的相对时间。count(读)视图中每个点的数据个数。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明日统计数据是作为一种历史数据保存的，到每天的24时保存当天的日统计数据。日统计数据是以天为单位计算的，以每天0时为基准。在上述视图统计数据结束时间表示法中，用绝对时间表示时，小时、分钟和秒没有意义，函数执行时小时、分钟和秒将被截掉，如“1997:7:30-9:24:12”，作为“1997:7:30-0:0:0”处理；用当前时间表示时，最后一个数据是当前日到当前时间的统计数据，如果统计数据结束时间选择NULL，当前时间是1998年3月5日8时25分36秒，日统计数据视图中最后一个数据是从1998年3月5日到1998年3月5日8时25分36秒的统计数据；用相对时间表示时，相对时间中小时、分钟和秒将被截掉，如“1-9:8:20”将被作为“1-0:0:0”处理，即日统计数据视图中最后一个数据是当日前一天的数据。CreateEventViewlongCreateEventView(long&viewID,char*database,longarea,longunit,longviewAttr,longcount)CreateEventView函数建立事件记录视图。参数viewID（写）事件记录视图标识。database（读）数据库名，单数据库系统为NULL。area（读）区域号，0表示所有区域。unit（读）单元号，0表示所有单元。viewAttr（读）视图属性，用下列符号表示：VIEW_ATTR_STATIC静态视图（缺省值)；VIEW_ATTR_ACTIVE动态视图；VIEW_ATTR_STANDARD标准视图，数据来自系统数据库（缺省值)；VIEW_ATTR_SIMULATE仿真视图，数据来自仿真数据库。count(读)视图中记录个数。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）CreateHisView－53－n实时数据平台C++接口函数参考手册longCreateHisView(long&viewID,char*database,longviewAttr,char*dataDesc,longtagCount,char*endTime,char*spanTime,longcount)CreateHisView函数建立历史数据视图。参数viewID（写）历史数据视图标识。database(读)数据库名，单数据库系统为NULL。viewAttr(读)视图属性，用下列符号表示：VIEW_ATTR_STANDARD标准视图，数据来自系统数据库（缺省值)；VIEW_ATTR_SIMULATE仿真视图，数据来自仿真数据库。dataDesc(读)视图数据TAG点描述表，字符串数组指针。数组中元素均为64字节的字符串，每个元素表示一个TAG点名称。因为仅有PV值保存历史数据，这里也可写成：<点名>.PV。tagCount(读)视图中TAG点个数。endTime(读)视图历史数据结束时间，视图数据结束时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示视图数据结束时间为某一确定时间；2、当前时间，用NULL时表示；3、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示视图数据结束时间为当前时间向前减去所表示的相对时间。spanTime(读)视图历史数据时间间隔，用相对时间表示，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”。count(读)视图中每个点的数据个数。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）CreateHourStaViewlongCreateHourStaView(long&viewID,char*database,longviewAttr,char*dataDesc,longtagCount,char*endTime,longcount)CreateHourStaView函数建立时统计数据视图。参数viewID（写）时统计数据视图标识。database(读)数据库名，单数据库系统为NULL。viewAttr(读)视图属性，用下列符号表示：VIEW_ATTR_STANDARD标准视图，数据来自系统数据库（缺省值)；VIEW_ATTR_SIMULATE仿真视图，数据来自仿真数据库。dataDesc(读)视图数据TAG点描述表，字符串数组指针。数组中元素均为64字节的字符串，每个元素表示一个TAG点名称。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。－53－n实时数据平台C++接口函数参考手册tagCount(读)视图中TAG点个数。endTime(读)视图统计数据结束时间，视图数据结束时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示视图数据结束时间为某一确定时间；2、当前时间，用NULL时表示；3、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示视图数据结束时间为当前时间向前减去所表示的相对时间。count(读)视图中每个点的数据个数。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明时统计数据是作为一种历史数据保存的，到每小时的60分钟结束时保存这个小时的时统计数据。时统计数据是以小时为单位计算的，以每小时0分为基准。在上述视图统计数据结束时间表示法中，用绝对时间表示时，分钟和秒没有意义，函数执行时分钟和秒将被截掉，如“1997:7:30-9:24:12”，作为“1997:7:30-9:0:0”处理；用当前时间表示时，最后一个数据是本小时0分到当前时间的统计数据，如果统计数据结束时间选择NULL，当前时间是1998年3月5日8时25分36秒，日统计数据视图中最后一个数据是从1998年3月5日8时到1998年3月5日8时25分36秒的统计数据；用相对时间表示时，相对时间中分钟和秒将被截掉，如“0-1:15:20”将被作为“0-1:0:0”处理，即时统计数据视图中最后一个数据是当日前一小时的数据。CreateTagAlarmViewlongCreateTagAlarmView(long&viewID,char*database,char*tagName,longviewAttr,longcount)CreateTagAlarmView函数建立单点报警记录视图。参数viewID（写）报警记录视图标识。database（读）数据库名，单数据库系统为NULL。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值有报警数据，这里也可写成：<点名>.PV。viewAttr（读）视图属性，用下列符号表示：VIEW_ATTR_STATIC静态视图（缺省值)；VIEW_ATTR_ACTIVE动态视图；VIEW_ATTR_STANDARD标准视图，数据来自系统数据库（缺省值)；VIEW_ATTR_SIMULATE仿真视图，数据来自仿真数据库。count(读)视图中记录个数。返回值：指示函数执行状态：不小于1的整数值函数执行成功；－53－n实时数据平台C++接口函数参考手册小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）CreateTagEventViewlongCreateTagEventView(long&viewID,char*database,char*tagDesc,longviewAttr,longcount)CreateTagEventView函数建立单点事件记录视图。参数viewID（写）事件记录视图标识。database（读）数据库名，单数据库系统为NULL。tagDesc（读）视图中的一个TAG点参数描述，字符串指针。如果仅写TAG点名称，取这个TAG点所有参数发生的所有事件；如果写成：.<参数名称>，取指定TAG点指定参数发生的所有事件。viewAttr（读）视图属性，用下列符号表示：VIEW_ATTR_STATIC静态视图（缺省值)；VIEW_ATTR_ACTIVE动态视图；VIEW_ATTR_STANDARD标准视图，数据来自系统数据库（缺省值)；VIEW_ATTR_SIMULATE仿真视图，数据来自仿真数据库。count(读)视图中记录个数。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）DeleteViewlongDeleteView(longviewID)DeleteView函数删除数据视图。参数viewID（读）数据视图标识。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）EnableUserWriteDevicelongEnableUserWriteDevice(longonOff)EnableUserWriteDevice函数设置用户级的允许/禁止回送现场设备数据控制开关。参数onOff（读）控制开关，控制开关的开关状态用下列符号表示：ENABLE_WRITE_DEVICE开状态，即允许回送现场设备数据；－53－n实时数据平台C++接口函数参考手册DISABLE_WRITE_DEVICE关状态，即禁止回送现场设备数据；返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明缺省情况下，每个用户被设成禁止回送现场设备状态，每个视图被设成允许回送现场设备状态但只有用户和视图都被设成允许回送现场设备状态数据才能真正回送。如果某个用户被设成允许回送现场设备状态，则它所建的每个视图缺省情况下均被设成允许回送现场设备状态，此时进行视图提交的话就会将数据回送到下位机（或现场设备）。这时候也可以把具体某一个视图设成禁止回送现场设备状态。参见EnableViewWriteDeviceEnableViewWriteDevicelongEnableViewWriteDevice(longviewID,longonOff)EnableViewWriteDevice函数设置视图级的允许/禁止回送现场设备数据控制开关。参数viewID（读）实时数据视图标识。onOff（读）控制开关，控制开关的开关状态用下列符号表示：ENABLE_WRITE_DEVICE开状态，即允许回送现场设备数据；DISABLE_WRITE_DEVICE关状态，即禁止回送现场设备数据；返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明缺省情况下，每个用户被设成禁止回送现场设备状态，每个视图被设成允许回送现场设备状态但只有用户和视图都被设成允许回送现场设备状态数据才能真正回送。如果某个用户被设成允许回送现场设备状态，则它所建的每个视图缺省情况下均被设成允许回送现场设备状态，此时进行视图提交的话就会将数据回送到下位机（或现场设备）。这时候也可以把具体某一个视图设成禁止回送现场设备状态。参见EnableUserWriteDeviceGetDataCommitFlaglongGetDataCommitFlag(longviewID,longdataID)GetDataCommitFlag函数读实时数据视图中数据的提交标志，检测数据是否被提交。参数viewID（读）实时数据视图标识。－53－n实时数据平台C++接口函数参考手册dataID（读)TAG点参数数据标识。返回值：1：数据被提交；0：数据未被提交；小于0的整数值：函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDataCommitStatuslongGetDataCommitStatus(longviewID,longdataID,long&commitStatus)GetDataCommiStatus函数读实时数据视图中数据向实时数据库中提交后的状态，检测数据是否被提交到实时数据库中。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。commitStatus（写)实时数据视图中数据向实时数据库中提交后的状态。可能的状态值及其意义如下：Data_Success1数据成功提交Data_NotChange2成功提交与前一值相同的数据Data_SourceError-5由于数据源错误提交失败Data_UserLevelError-6由于用户级别错误提交失败Data_TagStateError-7由于点状态错误提交失败Data_ReadOnly-8由于数据源只读提交失败Data_HighLimit-9发生超高限错误提交失败Data_LowLimit-10发生超低限错误提交失败Data_OutputDisable-21由于输出禁止发生输出失败（数据写入数据库但不能向外设输出）Data_OutputHighLimit-22由于输出超高限发生输出失败（数据写入数据库但不能向外设输出）Data_OutputLowLimit-23由于输出超低限发生输出失败（数据写入数据库但不能向外设输出）Data_OutputModeError-25由于输出方式错误发生输出失败（数据写入数据库但不能向外设输出）Data_OutputStateError-26由于输出状态错误发生输出失败（数据写入数据库但不能向外设输出）返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明缺省情况下，每个用户被设成禁止回送现场设备状态，每个视图被设成允许回送现场设备参见GetDataID－53－n实时数据平台C++接口函数参考手册GetDataCommitTimelongGetDataCommitTime(longviewID,longdataID,char*sTime)GetDataCommitTime函数读实时数据视图中数据的提交时间。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。sTime（写）数据的提交时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDataExistlongGetDataExist(longviewID,longdataID)GetDataExist函数检查实时数据视图中的TAG点参数在数据库中是否存在。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。返回值：不小于1的整数值实时数据视图中的TAG点参数在数据库中存在；小于1的整数值实时数据视图中的TAG点参数在数据库中不存在；GetDataIDlongGetDataID(longviewID,char*dataDesc);GetDataID函数读实时数据视图中的数据标识。参数viewID（读）实时数据视图标识。dataDesc（读)视图中存在的TAG点参数名称。返回值：指示TAG点参数的数据标识或函数执行状态不小于0的整数值TAG点参数的数据标识；小于0的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataIntlongGetDataInt(longviewID,longdataID,long&dat)－53－n实时数据平台C++接口函数参考手册GetDataInt函数读实时数据视图中的整型数据。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。dat（写）TAG点参数整型数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDataModifyFlaglongGetDataModifyFlag(longviewID,longdataID)GetDataModifyFlag函数读实时数据视图中数据的修改标志，检测数据是否被修改。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。返回值：1：数据被修改；0：数据未被修改；小于0的整数值：函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDataModifyTimelongGetDataModifyTime(longviewID,longdataID,char*sTime)GetDataModifyTime函数读实时数据视图中数据的修改时间。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。sTime（写）数据的修改时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDataReallongGetDataReal(longviewID,longdataID,double&dat)－53－n实时数据平台C++接口函数参考手册GetDataReal函数读实时数据视图中的实型数据。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。dat（写）TAG点参数实型数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDataStatuslongGetDataStatus(longviewID,longdataID)GetDataStatus函数读实时数据视图中数据的状态。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。返回值：实时数据视图中数据的状态。参见GetDataIDGetDataStrlongGetDataStr(longviewID,longdataID,char*dat,longlength)GetDataStr函数读实时数据视图中的字符型数据。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。dat（写）TAG点参数字符型数据值。length（读)TAG点参数字符型数据值长度。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDataStrLengthlongGetDataStrLength(longviewID,longdataID)GetDataStrLength函数读实时数据视图中的字符型数据长度（数据字节数）。参数viewID（读）实时数据视图标识。－53－n实时数据平台C++接口函数参考手册dataID（读)TAG点参数数据标识。返回值：指示字符型数据长度或函数执行状态；不小于0的整数值字符型数据长度；小于0的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDataTagCommitFlaglongGetDataTagCommitFlag(longviewID,char*tagName)GetDataTagCommitFlag函数读实时数据视图中数据的提交标志，检测数据是否被提交。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。返回值：1：数据被提交；0：数据未被提交；小于0的整数值：函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataTagCommitStatuslongGetDataTagCommitStatus(longviewID,char*tagName,long&commitStatus)GetDataTagCommiStatus函数读实时数据视图中数据向实时数据库中提交后的状态，检测数据是否被提交到实时数据库中。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。commitStatus（写)实时数据视图中数据向实时数据库中提交后的状态。可能的状态值及其意义如下：Data_Success1数据成功提交Data_NotChange2成功提交与前一值相同的数据Data_SourceError-5由于数据源错误提交失败Data_UserLevelError-6由于用户级别错误提交失败Data_TagStateError-7由于点状态错误提交失败Data_ReadOnly-8由于数据源只读提交失败Data_HighLimit-9发生超高限错误提交失败Data_LowLimit-10发生超低限错误提交失败Data_OutputDisable-21由于输出禁止发生输出失败（数据写入数据库但不能向外设输出）－53－n实时数据平台C++接口函数参考手册Data_OutputHighLimit-22由于输出超高限发生输出失败（数据写入数据库但不能向外设输出）Data_OutputLowLimit-23由于输出超低限发生输出失败（数据写入数据库但不能向外设输出）Data_OutputModeError-25由于输出方式错误发生输出失败（数据写入数据库但不能向外设输出）Data_OutputStateError-26由于输出状态错误发生输出失败（数据写入数据库但不能向外设输出）返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataTagCommitTimelongGetDataTagCommitTime(longviewID,char*tagName,char*sTime)GetDataTagCommitTime函数读实时数据视图中数据的提交时间。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。sTime（写）数据的提交时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataTagExistlongGetDataTagExist(longviewID,char*tagName)GetDataTagExist函数检查实时数据视图中的TAG点参数在数据库中是否存在。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。返回值：不小于1的整数值实时数据视图中的TAG点参数在数据库中存在；小于1的整数值实时数据视图中的TAG点参数在数据库中不存在；－53－n实时数据平台C++接口函数参考手册GetDataTagIntlongGetDataTagInt(longviewID,char*tagName,long&dat)GetDataTagInt函数读实时数据视图中的整型数据。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。dat（写）TAG点参数整型数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataTagModifyFlaglongGetDataTagModifyFlag(longviewID,char*tagName)GetDataTagModifyFlag函数读实时数据视图中数据的修改标志，检测数据是否被修改。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。返回值：1：数据被修改；0：数据未被修改；小于0的整数值：函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataTagModifyTimelongGetDataTagModifyTime(longviewID,char*tagName,char*sTime)GetDataTagModifyTime函数读实时数据视图中数据的修改时间。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。sTime（写）数据的修改时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）－53－n实时数据平台C++接口函数参考手册GetDataTagReallongGetDataTagReal(longviewID,char*tagName,double&dat)GetDataTagReal函数读实时数据视图中的实型数据。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。dat（写）TAG点参数实型数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataTagStatuslongGetDataTagStatus(longviewID,char*tagName)GetDataTagStatus函数读实时数据视图中数据的状态。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。返回值：实时数据视图中数据的状态。GetDataTagStrlongGetDataTagStr(longviewID,char*tagName,char*dat,longlength)GetDataTagStr函数读实时数据视图中的字符型数据。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。dat（写）TAG点参数字符型数据值。length（读)TAG点参数字符型数据值长度。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataTagStrLengthlongGetDataTagStrLength(longviewID,char*tagName)GetDataTagStrLength函数读实时数据视图中的字符型数据长度（数据字节数）。参数－53－n实时数据平台C++接口函数参考手册viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。返回值：指示字符型数据长度或函数执行状态；不小于0的整数值字符型数据长度；小于0的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataTagTypelongGetDataTagType(longviewID,char*tagName)GetDataTagType函数读实时数据视图中数据的数据类型。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。返回值：实时数据视图中数据的数据类型，数据类型分别为：DATA_TYPE_REAL实型；DATA_TYPE_INTEGER整型；DATA_TYPE_STRING字符型。返回小于1的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）GetDataTagUpdateFlaglongGetDataTagUpdateFlag(longviewID,char*tagName)GetDataTagUpdateFlag函数读实时数据视图中数据的更新标志，检测数据是否被实时数据平台数据库中的数据更新。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。返回值：1：数据被更新；0：数据未被更新；小于0的整数值：函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataTagUpdateTimelongGetDataTagUpdateTime(longviewID,char*tagName,char*sTime);GetDataTagUpdateTime函数读实时数据视图中数据的更新时间。参数viewID（读）实时数据视图标识。－53－n实时数据平台C++接口函数参考手册tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。sTime（写）数据的更新时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetDataTypelongGetDataType(longviewID,longdataID);GetDataType函数读实时数据视图中数据的数据类型。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。返回值：实时数据视图中数据的数据类型，数据类型分别为：DATA_TYPE_REAL实型；DATA_TYPE_INTEGER整型；DATA_TYPE_STRING字符型。返回小于1的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDataUpdateFlaglongGetDataUpdateFlag(longviewID,longdataID)GetDataUpdateFlag函数读实时数据视图中数据的更新标志，检测数据是否被实时数据平台数据库中的数据更新。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。返回值：1：数据被更新；0：数据未被更新；小于0的整数值：函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDataUpdateTimelongGetDataUpdateTime(longviewID,longdataID,char*sTime);GetDataUpdateTime函数读实时数据视图中数据的更新时间。参数viewID（读）实时数据视图标识。－53－n实时数据平台C++接口函数参考手册dataID（读)TAG点参数数据标识。sTime（写）数据的更新时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）参见GetDataIDGetDayStaTagAveragelongGetDayStaTagAverage(longviewID,char*tagName,char*datTime,double&dat)GetDayStaTagAverage函数取日统计数据视图中一个TAG点的某一天实时数据的平均值。参数viewID（读）日统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。datTime（读）要取的统计数据值的时间，时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取这一确定时刻所在日的实时数据平均值；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示取时统计数据视图中数据结束时间向前减去所表示相对时间的那一时刻所在日的实时数据平均值。3、NULL，时统计数据视图中数据结束时间的那一天0时到数据结束时间的实时数据平均值，即视图中最后一个数据。dat（写）TAG点日实时数据平均值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明在上述取日视图统计数据的时间表示法中，如果取统计数据的时间选择NULL，表示取视图建立那一天0时到视图建立那一时刻之间的实时数据平均值，与取数据的时间无关；用相对时间表示时，相对时间中小时、分钟和秒将被截掉，如“1-8:15:20”将被作为“1-8:0:0”处理，即取建立视图那一时刻上一日0时起一天的实时数据平均值。GetDayStaTagMaxlongGetDayStaTagMax(longviewID,char*tagName,char*datTime,double&dat,char*maxTime)GetDayStaTagMax函数取日统计数据视图中一个TAG－53－n实时数据平台C++接口函数参考手册点的某一天中实时数据出现的最大值和最大值出现的时间。参数viewID（读）日统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。datTime（读）要取的统计数据值的时间，时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取这一确定时刻所在日内的实时数据出现的最大值和最大值出现的时间；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示取时统计数据视图中数据结束时间向前减去所表示相对时间的那一时刻所在日实时数据出现的最大值和最大值出现的时间；3、NULL，时统计数据视图中数据结束时间的那一天0小时起到数据结束时间之间实时数据出现的最大值和最大值出现的时间，即视图中最后一个数据。dat（写）TAG点实时数据出现的最大值。maxTime（写）最大值出现的时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明在上述取日视图统计数据的时间表示法中，如果取统计数据的时间选择NULL，表示取视图建立那一个天0小时到视图建立那一时刻之间的实时数据最大值和最大值出现的时间，与取数据的时间无关；用相对时间表示时，相对时间中小时、分钟和秒将被截掉，如“1-8:15:20”将被作为“1-0:0:0”处理，即取建立视图的前一天0小时起一天内的实时数据最大值和最大值出现的时间。GetDayStaTagMinlongGetDayStaTagMin(longviewID,char*tagName,char*datTime,double&dat,char*minTime)GetDayStaTagMin函数取日统计数据视图中一个TAG点的某一天中实时数据出现的最小值和最小值出现的时间。参数viewID（读）日统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。datTime（读）要取的统计数据值的时间，时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取这一确定时刻所在日内的实时数据出现的最小值和最小值出现的时间；－53－n实时数据平台C++接口函数参考手册1、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示取时统计数据视图中数据结束时间向前减去所表示相对时间的那一时刻所在日实时数据出现的最小值和最小值出现的时间；2、NULL，时统计数据视图中数据结束时间的那一天0小时起到数据结束时间之间实时数据出现的最小值和最小值出现的时间，即视图中最后一个数据。dat（写）TAG点实时数据出现的最小值。minTime（写）最小值出现的时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明在上述取日视图统计数据的时间表示法中，如果取统计数据的时间选择NULL，表示取视图建立那一个天0小时到视图建立那一时刻之间的实时数据最小值和最小值出现的时间，与取数据的时间无关；用相对时间表示时，相对时间中小时、分钟和秒将被截掉，如“1-8:15:20”将被作为“1-0:0:0”处理，即取建立视图的前一天0小时起一天内的实时数据最小值和最小值出现的时间。GetDayStaTagTotallongGetDayStaTagTotal(longviewID,char*tagName,确char*datTime,double&dat)GetDayStaTagTotal函数取时统计数据视图中一个TAG点某一天实时数据的累计值。参数viewID（读）日统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。datTime（读）要取的统计数据值的时间，时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取这一确定时刻所在日内的实时数据累计值；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示取时统计数据视图中数据结束时间向前减去所表示相对时间的那一时刻所在的日内的实时数据累计值；3、NULL，日统计数据视图中数据结束时间的那一天0小时起到数据结束时间之间的实时数据累计值，即视图中最后一个数据。dat（写）TAG点统计数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；－53－n实时数据平台C++接口函数参考手册注：（函数执行失败原因可根据返回值参阅附录A）说明在上述取日视图统计数据的时间表示法中，如果取统计数据的时间选择NULL，表示取视图建立那一天0小时起到视图建立那一时刻之间的实时数据累计值，与取数据的时间无关；用相对时间表示时，相对时间中小时、分钟和秒将被截掉，如“1-8:15:20”将被作为“1-0:0:0”处理，即取建立视图那一时刻前一天0小时起一天内的实时数据累计值。GetHisTagDataStatuslongGetHisTagDataStatus(longviewID,char*tagName,char*datTime,long&status)GetHisTagDataStatus函数读历史数据视图中一个TAG点的一个历史数据的数据状态。参数viewID（读）历史数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存历史数据，这里也可写成：<点名>.PV。datTime（读）历史数据值的时间，历史数据值的时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取某一确定时间的历史数据的数据状态值；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示取历史数据视图中数据结束时间向前减去所表示相对时间的那一时刻的历史数据的数据状态值。（注：历史数据视图中数据结束时间是在视图建立时确定的，与取数据的时间无关。）3、NULL，历史数据视图中数据结束时间的历史数据值，即视图中最后一个数据的数据状态值。status（写）TAG点历史数据的数据状态。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetHisTagIntlongGetHisTagInt(longviewID,char*tagName,char*datTime,long&dat)GetHisTagInt函数取历史数据视图中的一个整型数据。参数viewID（读）历史数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存历史数据，这里也可写成：<点名>.PV。datTime（读）历史数据值的时间，历史数据值的时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取某一确定时间的历史数据值；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”－53－n实时数据平台C++接口函数参考手册表示取历史数据视图中数据结束时间向前减去所表示相对时间的那一时刻的历史数据值。（注：历史数据视图中数据结束时间是在视图建立时确定的，与取数据的时间无关。）1、NULL，历史数据视图中数据结束时间的历史数据值，即视图中最后一个数据值。dat（写）TAG点整型历史数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetHisTagReallongGetHisTagReal(longviewID,char*tagName,char*datTime,double&dat)GetHisTagReal函数取历史数据视图中的一个实型数据。参数viewID（读）历史数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存历史数据，这里也可写成：<点名>.PV。datTime（读）历史数据值的时间，历史数据值的时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取某一确定时间的历史数据值；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示取历史数据视图中数据结束时间向前减去所表示相对时间的那一时刻的历史数据值。（注：历史数据视图中数据结束时间是在视图建立时确定的，与取数据的时间无关。）3、NULL，历史数据视图中数据结束时间的历史数据值，即视图中最后一个数据值。dat（写）TAG点实型历史数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetHisTagStatuslongGetHisTagStatus(longviewID,char*tagName)GetHisTagStatus函数取历史数据视图中的一个TAG点的数据状态。参数viewID（读）历史数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存历史数据，这里也可写成：<点名>.PV。返回值：－53－n实时数据平台C++接口函数参考手册历史数据视图中TAG点的数据状态。GetHisTagTypelongGetHisTagType(longviewID,char*tagName)GetHisTagType函数取历史数据视图中一个TAG点的数据类型。参数viewID（读）历史数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存历史数据，这里也可写成：<点名>.PV。返回值：历史数据视图中TAG点的数据类型，数据类型分别为：DATA_TYPE_REAL实型；DATA_TYPE_INTEGER整型；DATA_TYPE_STRING字符型。返回小于0的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）GetHourStaTagAveragelongGetHourStaTagAverage(longviewID,char*tagName,char*datTime,double&dat)GetHourStaTagAverage函数取时统计数据视图中一个TAG点的某一小时实时数据的平均值。参数viewID（读）时统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。datTime（读）要取的统计数据值的时间，时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取这一确定时刻所在的小时内的实时数据平均值；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示取时统计数据视图中数据结束时间向前减去所表示相对时间的那一时刻所在的小时内的实时数据平均值。3、NULL，时统计数据视图中数据结束时间的那个小时0分到数据结束时间的实时数据平均值，即视图中最后一个数据。dat（写）TAG点小时实时数据平均值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明在上述取时视图统计数据的时间表示法中，如果取统计数据的时间选择NULL，表示取视图建立那一个小时0－53－n实时数据平台C++接口函数参考手册分到视图建立那一时刻之间的实时数据平均值，与取数据的时间无关；用相对时间表示时，相对时间中分钟和秒将被截掉，如“0-1:15:20”将被作为“0-1:0:0”处理，即取建立视图那一时刻前一个小时0分起一小时内的实时数据平均值。GetHourStaTagMaxlongGetHourStaTagMax(longviewID,char*tagName,char*datTime,double&dat,char*maxTime)GetHourStaTagMax函数取时统计数据视图中一个TAG点的某一小时中实时数据出现的最大值和最大值出现的时间。参数viewID（读）时统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。datTime（读）要取的统计数据值的时间，时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取这一确定时刻所在小时内的实时数据出现的最大值和最大值出现的时间；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示取时统计数据视图中数据结束时间向前减去所表示相对时间的那一时刻所在的小时内实时数据出现的最大值和最大值出现的时间；3、NULL，时统计数据视图中数据结束时间的那个小时0分到数据结束时间之间实时数据出现的最大值和最大值出现的时间，即视图中最后一个数据。dat（写）TAG点实时数据出现的最大值。maxTime（写）最大值出现的时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明在上述取时视图统计数据的时间表示法中，如果取统计数据的时间选择NULL，表示取视图建立那一个小时0分到视图建立那一时刻之间的实时数据最大值和最大值出现的时间，与取数据的时间无关；用相对时间表示时，相对时间中分钟和秒将被截掉，如“0-1:15:20”将被作为“0-1:0:0”处理，即取建立视图那一时刻前一小时0分起一小时内的实时数据最大值和最大值出现的时间。GetHourStaTagMinlongGetHourStaTagMin(longviewID,char*tagName,char*datTime,double&dat,char*minTime)GetHourStaTagMin函数取时统计数据视图中一个TAG点的某一小时中实时数据出现的最小值和最小值出现的时间。－53－n实时数据平台C++接口函数参考手册参数viewID（读）时统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。datTime（读）要取的统计数据值的时间，时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取这一确定时刻所在小时内的实时数据出现的最小值和最小值出现的时间；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示取时统计数据视图中数据结束时间向前减去所表示相对时间的那一时刻所在的小时内实时数据出现的最小值和最小值出现的时间；3、NULL，时统计数据视图中数据结束时间的那个小时0分到数据结束时间之间实时数据出现的最小值和最小值出现的时间，即视图中最后一个数据。dat（写）TAG点统计数据值。minTime（写）最小值出现的时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明在上述取时视图统计数据的时间表示法中，如果取统计数据的时间选择NULL，表示取视图建立那一个小时0分到视图建立那一时刻之间的实时数据最小值和最小值出现的时间，与取数据的时间无关；用相对时间表示时，相对时间中分钟和秒将被截掉，如“0-1:15:20”将被作为“0-1:0:0”处理，即取建立视图那一时刻前一个小时0分起一小时内的实时数据最小值和最小值出现的时间。GetHourStaTagTotallongGetHourStaTagTotal(longviewID,char*tagName,char*datTime,double&dat)GetHourStaTagTotal函数取时统计数据视图中一个TAG点的某一小时中实时数据的累计值。参数viewID（读）时统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。datTime（读）要取的统计数据值的时间，时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取这一确定时刻所在小时内的实时数据累计值；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”－53－n实时数据平台C++接口函数参考手册表示取时统计数据视图中数据结束时间向前减去所表示相对时间的那一时刻所在的小时内的实时数据累计值；1、NULL，时统计数据视图中数据结束时间的那个小时0分到数据结束时间之间的实时数据累计值，即视图中最后一个数据。dat（写）TAG点统计数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明在上述取时视图统计数据的时间表示法中，如果取统计数据的时间选择NULL，表示取视图建立那一个小时0分到视图建立那一时刻之间的实时数据累计值，与取数据的时间无关；用相对时间表示时，相对时间中分钟和秒将被截掉，如“0-1:15:20”将被作为“0-1:0:0”处理，即取建立视图那一时刻前一个小时0分起一小时内的实时数据累计值。GetRtdbTagCountlongGetRtdbTagCount()GetRtdbTagCount函数读实时数据平台数据库中已建的TAG点个数。返回值：实时数据平台数据库中TAG点个数；返回小于0的整数值表示函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetRtdbTagNamelongGetRtdbTagName(char*tagName,longcount,longstart=1)GetRtdbTagName函数读实时数据平台数据库中已建的TAG点名称。参数tagName（写）TAG点名称，字符串数组指针。数组中元素均为16字节的字符串，每个元素表示一个TAG点名称。count（读）要读的TAG点名称个数。start（读）从实时数据平台数据库中读TAG点名称的起始序号。返回值：实际读出的TAG点名称个数；返回小于0的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）GetStaTagDataStatuslongGetStaTagDataStatus(longviewID,char*tagName,char*datTime,long&status)GetStaTagDataStatus函数读统计数据视图中一个TAG点的一个统计数据的数据状态。参数－53－n实时数据平台C++接口函数参考手册viewID（读）统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存历史数据，这里也可写成：<点名>.PV。datTime（读）要取的统计数据值的时间，时间有三种方法表示：1、绝对时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”，表示取这一确定时刻所在的小时内的实时数据平均值；2、相对时间，时间格式为“DD-HH:MM:SS”，意义为“天-时：分：秒”表示取时统计数据视图中数据结束时间向前减去所表示相对时间的那一时刻所在的小时内的实时数据平均值。3、NULL，时统计数据视图中数据结束时间的那个小时0分到数据结束时间的实时数据平均值，即视图中最后一个数据。status（写）TAG点统计数据的数据状态。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetStaTagStatuslongGetStaTagStatus(longviewID,char*tagName)GetStaTagStatus函数取统计数据视图中的一个TAG点的数据状态。参数viewID（读）统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。返回值：统计数据视图中TAG点的数据状态。GetUserLevellongGetUserLevel(void)GetUserLevel函数读当前设置的用户级别。返回值用户级别，用户级别用下列符号表示：USERLEVEL_GUEST客户级；USERLEVEL_OPER操作员级；USERLEVEL_ENGINEER工程师级；USERLEVEL_SYSTEM系统级。返回小于1的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）参见SetUserLevel－53－n实时数据平台C++接口函数参考手册GetUserWriteDeviceStatuslongGetUserWriteDeviceStatus(void)GetUserWriteDeviceStatus函数读当前设置的用户级的允许/禁止回送现场设备数据控制开关的状态。返回值控制开关的开关状态，控制开关的开关状态用下列符号表示：ENABLE_WRITE_DEVICE开状态，即允许回送现场设备数据；DISABLE_WRITE_DEVICE关状态，即禁止回送现场设备数据；返回小于1的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）参见EnableUserWriteDeviceGetViewDataCountlongGetViewDataCount(longviewID)GetViewDataCount函数取一个数据视图中的数据个数。参数viewID（读）数据视图标识。返回值：数据视图中的数据个数；返回小于0的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）GetViewDataDesclongGetViewDataDesc(longviewID,longdataID,char*desc)GetViewDataDesc函数读一个数据标识相应保存在实时视图中TAG点名的描述串。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。desc（写）TAG点名描述串，64字节的字符串指针。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明一般地，保存在实时视图中TAG点名的描述串与用户建视图时所用的TAG点名是一致的，但是，当建视图时TAG点参数描述表中某TAG点仅描述为<点名>形式，则视图会按隐式规则将此TAG点的所有参数的PV项自动建成，这时保存在实时视图中这一部分的TAG点名的描述串是视图自动生成的。利用此函数则可以取出视图中任一TAG点名描述串。GetViewEndTime－53－n实时数据平台C++接口函数参考手册longGetViewEndTime(longviewID,char*endTime)GetViewEndTime函数取历史数据视图或统计数据视图中视图数据的结束时间。参数viewID（读）实时数据视图标识。endTime（写）历史数据视图或统计数据视图中视图数据的结束时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetViewStartTimelongGetViewStartTime(longviewID,char*startTime)GetViewStartTime函数取历史数据视图或统计数据视图中视图数据的起始时间。参数viewID（读）实时数据视图标识。startTime（写）历史数据视图或统计数据视图中视图数据的起始时间，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）GetViewWriteDeviceStatuslongGetViewWriteDeviceStatus(void)GetViewWriteDeviceStatus函数读当前设置的视图级的允许/禁止回送现场设备数据控制开关的状态。返回值控制开关的开关状态，控制开关的开关状态用下列符号表示：ENABLE_WRITE_DEVICE开状态，即允许回送现场设备数据；DISABLE_WRITE_DEVICE关状态，即禁止回送现场设备数据；返回小于1的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）参见EnableViewWriteDeviceIsRTDBConnectlongIsRTDBConnect()IsRTDBConnect－53－n实时数据平台C++接口函数参考手册函数判断是否与实时数据平台连接成功。如果函数执行成功表示用户程序与实时数据平台连接成功；如果函数执行失败表示实时数据平台没有起动，或者CUserApi类实例建立失败，返回错误状态。返回值不小于1的整数值用户程序与实时数据平台连接成功；小于1的整数值用户程序与实时数据平台连接失败；IsViewTagAllValidlongIsViewTagAllValid(longviewID)IsViewTagAllValid函数判断一个已建成的实时数据视图中是否所有的实时数据状态都正常。如果函数执行成功表示这一实时数据视图中所有的实时数据状态都正确；如果函数执行失败表示这一实时数据视图中至少有一个或一个以上的实时数据状态不正确。参数viewID（读）实时数据视图标识。返回值不小于1的整数值实时数据视图中所有的实时数据状态都正确；小于1的整数值实时数据视图中至少有一个或一个以上的实时数据状态不正确；PutDataIntlongPutDataInt(longviewID,longdataID,longdat)PutDataInt函数向实时数据视图中写整型数据。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。dat（读）要写的整型数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）PutDataReallongPutDataReal(longviewID,longdataID,doubledat)PutDataReal函数向实时数据视图中写实型数据。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。dat（读）要写的实型数据值。返回值：指示函数执行状态：－53－n实时数据平台C++接口函数参考手册不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）PutDataStrlongPutDataStr(longviewID,longdataID,char*dat,longlength)PutDataReal函数向实时数据视图中写字符型数据。参数viewID（读）实时数据视图标识。dataID（读)TAG点参数数据标识。dat（读）要写的字符串数据指针。length（读）要写的字符串数据长度。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）PutDataTagIntlongPutDataTagInt(longviewID,char*tagName,longdat)PutDataTagInt函数向实时数据视图中写整型数据。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。dat（读）要写的整型数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）PutDataTagReallongPutDataTagReal(longviewID,char*tagName,doubledat)PutDataTagReal函数向实时数据视图中写实型数据。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。dat（读）要写的实型数据值。返回值：指示函数执行状态：不小于1的整数值函数执行成功；－53－n实时数据平台C++接口函数参考手册小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）PutDataTagStrlongPutDataTagStr(longviewID,char*tagName,char*dat,longlength)PutDataTagStr函数向实时数据视图中写字符型数据。参数viewID（读）实时数据视图标识。tagName（读)视图中的一个TAG点参数的名称，字符串指针。格式为：<点名>.<参数名>.<细目名>。dat（读）要写的字符串数据指针。length（读）要写的字符串数据长度。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）ReadAlarmReportlongReadAlarmReport(longviewID,ALARM_VIEW_DATA*pAlarm,longcount,longstart)ReadAlarmReport函数读报警记录视图（包括单TAG点报警记录视图）中多个报警记录。参数viewID（读）报警记录视图标识。pAlarm（写）报警记录数据结构指针，报警记录数据结构如下：typedefstruct{unsignedlongtime;//报警时间(到秒级)longmsec;//毫秒级报警时间；longarea;//区域号longunit;//单元号chartagName[16];//TAG点名称charparName[16];//TAG点参数名称chartagDesc[32];//TAG点描述doublepv;//TAG点PV值longlevel;//报警级别longalarm_DV;//开关量报警状态longalarm_LO;//低报报警状态longalarm_LL;//低低报报警状态longalarm_HI;//高报报警状态longalarm_HH;//高高报报警状态longalarm_DEV;//偏差报警状态longalarm_ROC;//变化率报警状态－53－n实时数据平台C++接口函数参考手册longalarm_ACK;//确认报警状态}ALARM_VIEW_DATA;count（读）要读的报警记录个数。start（读）从报警数据视图中读报警记录的起始序号。返回值读出的报警记录个数；返回小于0的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）ReadDataCommitStatuslongReadDataCommitStatus(longviewID,long*commitStatus,longcount,longstart=0)ReadDataCommitStatus函数读实时数据视图中多个数据向实时数据库中提交后的状态，检测数据是否被提交到实时数据库中。参数viewID（读）实时数据视图标识。commitStatus（写)实时数据视图中数据向实时数据库中提交后的状态,整型数组指针。可能的状态值及其意义如下：Data_Success1数据成功提交Data_NotChange2成功提交与前一值相同的数据Data_SourceError-5由于数据源错误提交失败Data_UserLevelError-6由于用户级别错误提交失败Data_TagStateError-7由于点状态错误提交失败Data_ReadOnly-8由于数据源只读提交失败Data_HighLimit-9发生超高限错误提交失败Data_LowLimit-10发生超低限错误提交失败Data_OutputDisable-21由于输出禁止发生输出失败（数据写入数据库但不能向外设输出）Data_OutputHighLimit-22由于输出超高限发生输出失败（数据写入数据库但不能向外设输出）Data_OutputLowLimit-23由于输出超低限发生输出失败（数据写入数据库但不能向外设输出）Data_OutputModeError-25由于输出方式错误发生输出失败（数据写入数据库但不能向外设输出）Data_OutputStateError-26由于输出状态错误发生输出失败（数据写入数据库但不能向外设输出）count（读）要读的数据状态个数。start（读）从实时数据视图中读数据状态的起始序号。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）－53－n实时数据平台C++接口函数参考手册参见GetDataCommitStatusReadDataStatuslongReadDataStatus(longviewID,long*status,longcount,longstart=0)ReadDataStatus函数读实时数据视图中多个数据的数据状态。参数viewID（读）实时数据视图标识。dataType（写)TAG点参数数据的数据状态，整型数组指针。count（读）要读的数据状态个数。start（读）从实时数据视图中读数据状态的起始序号。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）ReadDataTypelongReadDataType(longviewID,long*dataType,longcount,longstart=0)ReadDataType函数读实时数据视图中多个数据的数据类型。参数viewID（读）实时数据视图标识。dataType（写)TAG点参数数据的数据类型，整型数组指针。count（读）要读的数据类型个数。start（读）从实时数据视图中读数据类型的起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）ReadDayStaTagAveragelongReadDayStaTagAverage(longviewID,char*tagName,double*dat,longcount,longstart=0)ReadDayStaTagAverage函数读日统计数据视图中一个TAG点的多个实时数据平均值。参数viewID（读）时统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。dat（写)日统计数据视图中的实时数据平均值，实型数组指针。count（读）要读的数据个数。－53－n实时数据平台C++接口函数参考手册start（读）从日统计数据视图中读数据的起始序号。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明日统计数据视图中数据按照时间顺序从前向后排列，第一个数据为开始时间的数据，最后一个为结束时间的数据。ReadDayStaTagAverage函数从时统计数据视图中序号为start的数据开始顺序读数据，读到count个数据为止。ReadDayStaTagMaxlongReadDayStaTagMax(longviewID,char*tagName,double*dat,char*datTime,longcount,longstart=0)ReadDayStaTagMax函数读日统计数据视图中一个TAG点的多日的实时数据最大值和最大值出现的时间。参数viewID（读）日统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。dat（写)日统计数据视图中的实时数据最大值，实型数组指针。datTime（写）最大值出现的时间，字符串指针数组，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。count（读）要读的数据个数。start（读）从日统计数据视图中读数据的起始序号。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明时统计数据视图中数据按照时间顺序从前向后排列，第一个数据为开始时间的数据，最后一个为结束时间的数据。ReadDayStaTagMax函数从时统计数据视图中序号为start的数据开始顺序读数据，读到count个数据为止。ReadDayStaTagMinlongReadDayStaTagMin(longviewID,char*tagName,double*dat,char*datTime,longcount,longstart=0);ReadDayStaTagMin函数读日统计数据视图中一个TAG点的多日的实时数据最小值和最小值出现的时间。参数viewID（读）日统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。dat（写)日统计数据视图中的实时数据最小值，实型数组指针。－53－n实时数据平台C++接口函数参考手册datTime（写）最小值出现的时间，字符串指针数组，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。count（读）要读的数据个数。start（读）从日统计数据视图中读数据的起始序号。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明时统计数据视图中数据按照时间顺序从前向后排列，第一个数据为开始时间的数据，最后一个为结束时间的数据。ReadDayStaTagMin函数从时统计数据视图中序号为start的数据开始顺序读数据，读到count个数据为止。ReadDayStaTagTotallongReadDayStaTagTotal(longviewID,char*tagName,double*dat,longcount,longstart=0)ReadDayStaTagTotal函数读日统计数据视图中一个TAG点的多个实时数据累计值。参数viewID（读）日统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。dat（写)日统计数据视图中的实时数据累计值，实型数组指针。count（读）要读的数据个数。start（读）从日统计数据视图中读数据的起始序号。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明时统计数据视图中数据按照时间顺序从前向后排列，第一个数据为开始时间的数据，最后一个为结束时间的数据。ReadDayStaTagTotal函数从时统计数据视图中序号为start的数据开始顺序读数据，读到count个数据为止。ReadEventReportlongReadEventReport(longviewID,EVENT_VIEW_DATA*pEvent,longcount,longstart)ReadEventReport函数读事件记录视图（包括单点事件记录视图）中多个事件记录。参数viewID（读）事件记录视图标识。pEvent（写）事件记录数据结构指针，事件记录数据结构如下：typedefstruct{－53－n实时数据平台C++接口函数参考手册chartagName[16];//TAG点名称charparName[16];//参数名称charitemName[16];//细目名称charuserName[16];//产生事件的用户名longstation;//站号longnode;//结点号longarea;//区域号longunit;//单元号unsignedlongtime;//事件发生时间（到秒级）longmsec;//毫秒级事件发生时间longlevel;//事件级别longtype;//事件类型longstatus;//事件状态longrecordLevel;//报告级别charrecord[64];//事件报告}EVENT_VIEW_DATA;count（读）要读的事件记录个数。start（读）从事件视图中读事件记录的起始序号。返回值读出的事件记录个数；返回小于0的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）ReadHisTagDataStatuslongReadHisTagDataStatus(longviewID,char*tagName,long*status,longcount,longstart=0)ReadHisTagDataStatus函数读历史数据视图中一个TAG点的多个历史数据的数据状态。参数viewID（读）历史数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存历史数据，这里也可写成：<点名>.PV。status（写）TAG点历史数据的数据状态,整型指针数组。count（读）要读的数据状态个数。start（读）从实时数据视图中读数据状态的起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）ReadHisTagIntlongReadHisTagInt(longviewID,char*tagName,long*hisDat,longcount,longstart)ReadHisTagInt函数读历史数据视图中一个TAG点的多个整型历史数据。－53－n实时数据平台C++接口函数参考手册参数viewID（读）历史数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存历史数据，这里也可写成：<点名>.PV。hisDat（写)历史数据视图中的整型数据，整型数组指针。count（读）要读的数据个数。start（读）从历史数据视图中读数据的起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明历史数据视图中数据按照时间顺序从前向后排列，第一个数据为开始时间的数据，最后一个为结束时间的数据。ReadHisTagInt函数从历史数据视图中序号为start的数据开始顺序读，读到count个数据为止。ReadHisTagReallongReadHisTagReal(longviewID,char*tagName,double*hisDat,longcount,longstart)ReadHisTagReal函数读历史数据视图中一个TAG点的多个实型历史数据。参数viewID（读）历史数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存历史数据，这里也可写成：<点名>.PV。hisDat（写)历史数据视图中的实型数据，实型数组指针。count（读）要读的数据个数。start（读）从历史数据视图中读数据的起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明历史数据视图中数据按照时间顺序从前向后排列，第一个数据为开始时间的数据，最后一个为结束时间的数据。ReadHisTagReal函数从历史数据视图中序号为start的数据开始顺序读，读到count个数据为止。ReadHisTagStatuslongReadHisTagStatus(longviewID,long*status,longcount,longstart)ReadHisTagStatus函数读历史数据视图中多个TAG点的数据状态。参数viewID（读）历史数据视图标识。status（写)历史数据视图数据的数据状态，整型数组指针。count（读）要读的数据个数。－53－n实时数据平台C++接口函数参考手册start（读）从历史数据视图中读数据的起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明历史数据视图中TAG点的数据状态数据按照用户建视图时TAG名顺序从前向后排列，第一个数据为第一个TAG名状态，最后一个为最后一个TAG名状态。ReadHisTagStatus函数从历史数据视图中序号为start的数据开始顺序读数据状态，读到count个数据为止。ReadHisTagTypelongReadHisTagType(longviewID,long*type,longcount,longstart)ReadHisTagType函数读历史数据视图中多个TAG点的数据类型。参数viewID（读）历史数据视图标识。type（写)历史数据视图数据的数据状态，整型指针数组。count（读）要读的数据个数。start（读）从历史数据视图中读数据的起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明历史数据视图中TAG点的数据类型数据按照用户建视图时TAG名顺序从前向后排列，第一个数据为第一个TAG点的数据类型，最后一个为最后一个TAG点的数据类型。ReadHisTagType函数从历史数据视图中序号为start的数据开始顺序读TAG点的数据类型，读到count个数据为止。ReadHourStaTagAveragelongReadHourStaTagAverage(longviewID,char*tagName,double*dat,longcount,longstart=0)ReadHourStaTagAverage函数读时统计数据视图中一个TAG点的多个实时数据平均值。参数viewID（读）时统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。dat（写)时统计数据视图中的实时数据平均值，实型指针数组。count（读）要读的数据个数。start（读）从时统计数据视图中读数据的起始序号。返回值：指示函数执行状态：不小于1的整数值函数执行成功；－53－n实时数据平台C++接口函数参考手册小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明时统计数据视图中数据按照时间顺序从前向后排列，第一个数据为开始时间的数据，最后一个为结束时间的数据。ReadHourStaTagAverage函数从时统计数据视图中序号为start的数据开始顺序读数据，读到count个数据为止。ReadHourStaTagMaxlongReadHourStaTagMax(longviewID,char*tagName,double*dat,char*datTime,longcount,longstart=0)ReadHourStaTagMax函数读时统计数据视图中一个TAG点的多个小时的实时数据最大值和最大值出现的时间。参数viewID（读）时统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。dat（写)时统计数据视图中的实时数据最大值，实型指针数组。datTime（写）最大值出现的时间，字符串指针数组，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。count（读）要读的数据个数。start（读）从时统计数据视图中读数据的起始序号。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明时统计数据视图中数据按照时间顺序从前向后排列，第一个数据为开始时间的数据，最后一个为结束时间的数据。ReadHourStaTagMax函数从时统计数据视图中序号为start的数据开始顺序读数据，读到count个数据为止。ReadHourStaTagMinlongReadHourStaTagMin(longviewID,char*tagName,double*dat,char*datTime,longcount,longstart=0)ReadHourStaTagMin函数读时统计数据视图中一个TAG点的多个小时的实时数据最小值和最小值出现的时间。参数viewID（读）时统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。dat（写)时统计数据视图中的实时数据最小值，实型指针数组。datTime（写）最小值出现的时间，字符串指针数组，时间格式为“YYYY:MM:DD-HH:MM:SS”，意义为“年：月：日-时：分：秒”。count（读）要读的数据个数。start（读）从时统计数据视图中读数据的起始序号。返回值：－53－n实时数据平台C++接口函数参考手册指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明时统计数据视图中数据按照时间顺序从前向后排列，第一个数据为开始时间的数据，最后一个为结束时间的数据。ReadHourStaTagMin函数从时统计数据视图中序号为start的数据开始顺序读数据，读到count个数据为止。ReadHourStaTagTotallongReadHourStaTagTotal(longviewID,char*tagName,double*dat,longcount,longstart=0)ReadHourStaTagTotal函数读时统计数据视图中一个TAG点的多个实时数据累计值。参数viewID（读）时统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。dat（写)时统计数据视图中的实时数据累计值，实型指针数组。count（读）要读的数据个数。start（读）从统计数据视图中读数据的起始序号。返回值：指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明时统计数据视图中数据按照时间顺序从前向后排列，第一个数据为开始时间的数据，最后一个为结束时间的数据。ReadHourStaTagTotal函数从时统计数据视图中序号为start的数据开始顺序读数据，读到count个数据为止。ReadStaTagDataStatuslongReadStaTagDataStatus(longviewID,char*tagName,long*status,longcount,longstart=0)ReadStaTagDataStatus函数读统计数据视图中一个TAG点的多个统计数据的数据状态。参数viewID（读）统计数据视图标识。tagName（读）视图中的一个TAG点名称，字符串指针。因为仅有PV值保存统计数据，这里也可写成：<点名>.PV。status（写）TAG点统计数据的数据状态,整型指针数组。count（读）要读的数据状态个数。start（读）从统计数据视图中读数据状态的起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；－53－n实时数据平台C++接口函数参考手册小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）ReadStaTagStatuslongReadStaTagStatus(longviewID,long*status,longcount,longstart)ReadStaTagStatus函数读统计数据视图中多个TAG点的数据状态。参数viewID（读）统计数据视图标识。status（写)统计数据视图数据的数据状态，整型指针数组。count（读）要读的数据个数。start（读）从统计数据视图中读数据状态的起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明统计数据视图中TAG点的数据状态数据按照用户建视图时TAG名顺序从前向后排列，第一个数据为第一个TAG名状态，最后一个为最后一个TAG名状态。ReadStaTagStatus函数从统计数据视图中序号为start的数据开始顺序读数据状态，读到count个数据为止。ReadViewDataIntlongReadViewDataInt(longviewID,long*dat,longcount,longstart)ReadViewDataInt函数读实时数据视图中多个整型数据。参数viewID（读）实时数据视图标识。dat（写)实时数据视图中的整型数据，整型指针数组。count（读）要读的数据个数。start（读）从实时数据视图中读数据的起始序号。返回值读出的数据个数；返回小于0的整数值表示函数执行失败。注：（函数执行失败原因可根据返回值参阅附录A）说明ReadViewDataInt函数从实时数据视图中序号为start的数据开始顺序读，读到count个数据为止。如果碰到非整型数据，给数组元素赋零，表示该数据无意义。ReadViewDataReallongReadViewDataReal(longviewID,double*dat,longcount,longstart)ReadViewDataReal函数读实时数据视图中多个实型数据。参数viewID（读）实时数据视图标识。－53－n实时数据平台C++接口函数参考手册dat（写)实时数据视图中的实型数据，实型指针数组。count（读）要读的数据个数。start（读）从实时数据视图中读数据的起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明ReadViewDataReal函数从实时数据视图中序号为start的数据开始顺序读，读到count个数据为止。如果碰到非实型数据，给数组元素赋零，表示该数据无意义。SetUserLevellongSetUserLevel(longuserLevel)SetUserLevel函数设置用户级别。参数userLevel（读）用户级别，用户级别用下列符号表示：USERLEVEL_GUEST客户级；USERLEVEL_OPER操作员级；USERLEVEL_ENGINEER工程师级；USERLEVEL_SYSTEM系统级。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）SetViewSimulatelongSetViewSimulate(longviewID)SetViewSimulate函数将视图设置成仿真视图。参数viewID（读）视图标识。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明如果视图原来是标准视图，SetViewSimulate函数将视图设置成仿真视图，并且用仿真数据库中的数据更新视图数据；如果视图原来就是仿真视图，函数不起任何作用。SetViewStandardlongSetViewStandard(longviewID)－53－n实时数据平台C++接口函数参考手册SetViewStandard函数将视图设置成标准视图。参数viewID（读）视图标识。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明如果视图原来是仿真视图，SetViewStandard函数将视图设置成标准视图，并且用标准数据库中的数据更新视图数据；如果视图原来就是标准视图，函数不起任何作用。ViewDataUpdatelongViewDataUpdate(longviewID)ViewDataUpdate函数用实时数据平台数据库中的数据更新当前视图的数据。参数viewID（读）视图标识。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）WriteDataIntlongWriteDataInt(longviewID,long*dat,longcount,longstart=0)WriteDataInt函数向实时数据视图中写多个整型数据。参数viewID（读）实时数据视图标识。dat（读)实时数据视图中的整型数据，整型指针数组。count（读）要写的数据个数。start（读）向实时数据视图中写数据的视图数据起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明WriteDataInt函数从实时数据视图中序号为start的数据开始顺序写，写count个数据为止。如果碰到非整型数据，不进行写操作。WriteDataReallongWriteDataReal(longviewID,double*dat,longcount,longstart=0)WriteDataReal函数向实时数据视图中写多个实型数据。－53－n实时数据平台C++接口函数参考手册参数viewID（读）实时数据视图标识。dat（读)实时数据视图中的实型数据，实型指针数组。count（读）要写的数据个数。start（读）向实时数据视图中写数据的视图数据起始序号。返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）说明WriteDataReal函数从实时数据视图中序号为start的数据开始顺序写，写count个数据为止。如果碰到非实型数据，不进行写操作。WriteViewFilelongWriteViewFile(longviewID,char*fileName,longformat)WriteViewFile函数将数据视图的内容写成数据视图文本文件，数据视图中每个数据在文件中写一行。参数viewID（读）数据视图标识。fileName（读)视图数据文件名称。format（读）视图数据文件数据格式，format参数由标志位组成，标志位中两个标志位为文件打开方式标志位，所有视图都可以使用：VIEW_FILE_NEW建立新文件（缺省）；VIEW_FILE_APPEND在原有文件的后面添加数据。其它标志位为格式标志位，由数据视图类型决定，格式标志位决定文本行的内容，如果下列格式中有些选项没有选，文本数据行中去掉没有选的选项，内容排列顺序按下面列出的顺序排列，如果没有任何格式标志位，表示内容全选：1、实时数据视图文件，标志位如下：DATA_FORMAT_FULL全部内容（缺省）；DATA_FORMAT_NUMBER数据行序号；DATA_FORMAT_NAME点参数名称；DATA_FORMAT_DAT_TIME数据更新时间；DATA_FORMAT_STATUS数据状态；DATA_FORMAT_TYPE数据类型；DATA_FORMAT_DATA实时数据值；DATA_FORMAT_LENGTH字符型数据字符串长度。文件内容第1-5和第7列为数据说明部分，格式分别为"%5d,%64s,%s,%5d,%2d,%5d,"，其中：第1列“%5d,”为数据序号，第2列“%32s,”为点参数名称，第3列“%s,”为数据更新时间，第4列“%5d,”为数据状态，－53－n实时数据平台C++接口函数参考手册第5列“%2d,”为数据类型，第7列“%5d,”为字符型数据字符串长度，第6列为实时数据部分，格式为"%d"或"%f"或"%s"，其中：整型数据值为“%d,”。实型数据值为“%f,”。字符型数据值为“%s,”。2、历史数据视图文件，标志位如下：HIS_FORMAT_FULL全部内容（缺省）；HIS_FORMAT_NUMBER数据行序号；HIS_FORMAT_NAME点参数名称；HIS_FORMAT_DAT_TIME数据更新时间；HIS_FORMAT_STATUS数据状态；HIS_FORMAT_TYPE数据类型；HIS_FORMAT_DATA历史数据值。文件内容第1-5列为数据说明部分，格式分别为"%5d,%64s,%s,%3d,%3d"，其中：第1列“%5d,”为数据序号，第2列“%64s,”为点参数名称，第3列“%s,”为数据更新时间，第4列“%3d,”为数据状态，第5列“%3d,”为数据类型，第6列为历史数据部分，格式为"%d"或"%f"，其中：整型数据值为“%d,”。实型数据值为“%f,”。3、统计数据视图文件，标志位如下：STA_FORMAT_FULL全部内容（缺省）；STA_FORMAT_NUMBER数据行序号STA_FORMAT_NAME点参数名称；STA_FORMAT_DAT_TIME数据更新时间；STA_FORMAT_STATUS数据状态；STA_FORMAT_TOTAL累计值；STA_FORMAT_AVERAGE平均值；STA_FORMAT_MAX最大值；STA_FORMAT_MAXTIME最大值产生时间；STA_FORMAT_MIN最小值；STA_FORMAT_MINTIME最小值产生时间。文件内容第1-4列为数据说明部分，格式分别为"%5d,%64s,%s,%5d"，其中：第1列“%5d,”为数据序号，第2列“%64s,”为点参数名称，第3列“%s,”为数据更新时间，第4列“%5d,”为数据状态，－53－n实时数据平台C++接口函数参考手册第5-10列为统计数据部分，格式分别为"%f,%f,%f,%s,%f,%s"，其中：第5列“%f,”为累计值，第6列“%f,”为平均值，第7列“%f,”为最大值，第8列“%s,”为最大值产生时间，第9列“%f,”为最小值，第10列“%s,”为最小值产生时间.4、报警数据视图文件，标志位如下：ALARM_FORMAT_FULL全部内容（缺省）；ALARM_FORMAT_NUMBER数据行序号；ALARM_FORMAT_TIME报警时间；ALARM_FORMAT_MSEC报警毫秒时间；ALARM_FORMAT_AREA报警点区域号；ALARM_FORMAT_UNIT报警点单元号；ALARM_FORMAT_TAGNAME报警点点名；ALARM_FORMAT_PARNAME报警点参数名；ALARM_FORMAT_TAGDESC报警点点描述；ALARM_FORMAT_PV报警点PV值；ALARM_FORMAT_LEVEL报警级别；ALARM_FORMAT_DV开关量报警状态；ALARM_FORMAT_LO低报报警状态；ALARM_FORMAT_LL低低报报警状态；ALARM_FORMAT_HI高报报警状态；ALARM_FORMAT_HH高高报报警状态；ALARM_FORMAT_DEV偏差报警状态；ALARM_FORMAT_ROC变化率报警状态；ALARM_FORMAT_ACK确认报警状态；文件内容共18列，格式分别为"%d,%s,%d,%d,%d,%s,%s,%s,%f,%d,%d,%d,%d,%d,%d,%d,%d,%d,"，其中：第1列“%d,”为数据序号，第2列“%s,”报警时间，第3列“%d,”报警毫秒时间；第4列“%d,”为报警点区域号，第5列“%d,”为报警点单元号，第6列“%s,”为报警点点名，第7列“%s,”为报警点参数名，第8列“%s,”为报警点点描述，第9列“%s,”为报警点PV值，第10列“%s,”为报警级别，第11列“%s,”为开关量报警状态，第12列“%d,”为低报报警状态，－53－n实时数据平台C++接口函数参考手册第13列“%d,”为低低报报警状态，第14列“%d,”为高报报警状态，第15列“%d,”为高高报报警状态，第16列“%d,”为偏差报警状态，第17列“%d,”为变化率报警状态，第18列“%d,”为确认报警状态，5、事件数据视图文件，标志位如下：if(format==0||(format&EVENT_FORMAT_MSEC)>0)fprintf(pFile,"%d,",(pEvent+i)->msec);if(format==0||(format&EVENT_FORMAT_USERNAME)>0)fprintf(pFile,"%s,",(pEvent+i)->userName);if(format==0||(format&EVENT_FORMAT_AREA)>0)fprintf(pFile,"%d,",(pEvent+i)->area);if(format==0||(format&EVENT_FORMAT_UNIT)>0)fprintf(pFile,"%d,",(pEvent+i)->unit);if(format==0||(format&EVENT_FORMAT_TAGNAME)>0)fprintf(pFile,"%s,",(pEvent+i)->tagName);if(format==0||(format&EVENT_FORMAT_PARNAME)>0)fprintf(pFile,"%s,",(pEvent+i)->parName);if(format==0||(format&EVENT_FORMAT_ITEMNAME)>0)fprintf(pFile,"%s,",(pEvent+i)->itemName);if(format==0||(format&EVENT_FORMAT_LEVEL)>0)fprintf(pFile,"%d,",(pEvent+i)->level);if(format==0||(format&EVENT_FORMAT_STATUS)>0)fprintf(pFile,"%d,",(pEvent+i)->status);if(format==0||(format&EVENT_FORMAT_RECORD)>0)fprintf(pFile,"%s,",(pEvent+i)->record);if(format==0||(format&EVENT_FORMAT_RECORD_LEVEL)>0)fprintf(pFile,"%d,",(pEvent+i)->recordLevel);EVENT_FORMAT_FULL全部内容（缺省）；EVENT_FORMAT_NUMBER数据行序号；EVENT_FORMAT_TIME事件发生时间；EVENT_FORMAT_MSEC事件发生毫秒时间；EVENT_FORMAT_USERNAME产生事件的用户名；EVENT_FORMAT_AREA产生事件点区域号；EVENT_FORMAT_UNIT产生事件点单元号；EVENT_FORMAT_TAGNAME产生事件点点名；EVENT_FORMAT_PARNAME产生事件点点参数名；EVENT_FORMAT_ITEMNAME产生事件点细目名；EVENT_FORMAT_LEVEL产生事件级别；EVENT_FORMAT_STATUS产生事件状态；－53－n实时数据平台C++接口函数参考手册EVENT_FORMAT_RECORD产生事件内容；EVENT_FORMAT_RECORD_LEVEL用户设置事件级别；文件内容共13列，格式分别为"%d,%s,%d,%s,%d,%d,%s,%s,%s,%d,%d,%s,%d"，其中：第1列“%d,”为数据序号，第2列“%d,”为事件发生时间，第3列“%d,”事件发生毫秒时间，第4列“%s,”为产生事件的用户名，第5列“%d,”为产生事件点区域号，第6列“%d,”为产生事件点单元号，第7列“%s,”为产生事件点点名，第8列“%s,”为产生事件点点参数名，第9列“%s,”产生事件点细目名，第10列“%d,”为产生事件级别，第11列“%d,”为产生事件状态，第12列“%s,”为产生事件内容，第13列“%d,”用户设置事件级别，返回值指示函数执行状态：不小于1的整数值函数执行成功；小于1的整数值函数执行失败；注：（函数执行失败原因可根据返回值参阅附录A）附录A函数返回值代码表函数返回值标识名返回值含义说明INVALID_DATA_IDINVALID_TAG_NAME无郊的点名调用API函数时，引用了数据库中不存在的点名参数INVALID_DESC_NUMBER无郊的点名说明个数调用API函数创建视图时，引用了无郊的点名说明个数参数（如：错误地引用了负值）INVALID_DATA_NUMBER无郊的数据个数调用API函数创建视图时，引用了无郊的数据个数参数（如：错误地引用了负值）INVALID_SPAN_TIME无郊的时间跨度调用API函数创建视图时，引用了无郊的时间跨度参数（如：引用了负值作为时间跨度参数）INVALID_TIME无郊时间调用API－53－n实时数据平台C++接口函数参考手册函数时，引用了无郊的时间参数（如：引用的时间参数不在创建视图指定的时间范围内）INVALID_DATA_ID-501无郊的数据标识调用API函数时，引用了无郊的数据标识参数（如：错误地引用了负数作数据标识参数）INVALID_START_ID无郊的起始数据标识调用API函数创建视图时，引用了无郊的起始数据标识参数（如：错误地引用了负数作起始数据标识参数）INVALID_TIME_CONVERT_FLAG无郊的时间转换标志调用API函数转换时间格式时，引用了无郊的时间转换标志参数INVALID_TIME_STRING无郊的时间表达字符串调用API函数时，引用了无郊的时间表达字符串参数INVALID_VIEW_ID无郊的视图标识调用API函数时，引用了无郊的视图标识参数INVALID_STATION_ID-内部错误INVALID_USER_ID-内部错误BAD_DATA坏数据读取的数据在数据库中不存在或无郊BAD_DATA_ID坏数据标识指定的数据标识所对应的点无郊WRONG_DATA_TYPE错误的数据类型读取的数据的数据类型与读取时采用的读取方式的类型不符WRONG_VIEW_ATTRIBUTE错误的视图属性执行了与视图属性不符的操作NO_STATION-内部错误NO_SIMULATE仿真库故障可能仿真库未启动RTDB_FAIL数据库故障可能数据库未启动SYSTEM_ERROR-内部错误MEMORY_FAIL-内部错误－53－