欢迎来到三一办公! | 帮助中心 三一办公31ppt.com(应用文档模板下载平台)
三一办公
全部分类
  • 办公文档>
  • PPT模板>
  • 建筑/施工/环境>
  • 毕业设计>
  • 工程图纸>
  • 教育教学>
  • 素材源码>
  • 生活休闲>
  • 临时分类>
  • ImageVerifierCode 换一换
    首页 三一办公 > 资源分类 > DOC文档下载  

    C接口函数参考手册范本.doc

    • 资源ID:1163812       资源大小:217KB        全文页数:54页
    • 资源格式: DOC        下载积分:10金币
    快捷下载 游客一键下载
    会员登录下载
    三方登录下载: 微信开放平台登录 QQ登录  
    下载资源需要10金币
    邮箱/手机:
    温馨提示:
    用户名和密码都是您填写的邮箱或者手机号,方便查询和重复下载(系统自动生成)
    支付方式: 支付宝    微信支付   
    验证码:   换一换

    加入VIP免费专享
     
    账号:
    密码:
    验证码:   换一换
      忘记密码?
        
    友情提示
    2、PDF文件下载后,可能会被浏览器默认打开,此种情况可以点击浏览器菜单,保存网页到桌面,就可以正常下载了。
    3、本站不支持迅雷下载,请使用电脑自带的IE浏览器,或者360浏览器、谷歌浏览器下载即可。
    4、本站资源下载后的文档和图纸-无水印,预览文档经过压缩,下载后原文更清晰。
    5、试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓。

    C接口函数参考手册范本.doc

    word实时数据平台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+编程环境中调用APIVisual C+编程环境中,实时数据平台提供了两个头文件、一个引入库和一个动态连接库。文件分别名称为:两个头文件分别为和,其中分别包含了函数定义和符号定义。用户程序中如果要调用API,必须在程序中用#include包含这两个头文件。在用户程序工作台(Workspace)中,在选单project下选择Settings.,进入设置对话框,选择Link设置,在Object/library Modules下填入。用户程序运行时要保证能找到动态连接库。可以将放在用户程序的目录下,或者放在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的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录AAckTagAlarm 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的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录AAsciiTime long AsciiTime(TIME_DESC* bTime, char* sTime)AsciiTime函数将二进制时间转换成ASCII时间。参数bTime读二进制时间数据结构。TIME_DESC数据结构格式:typedef struct long time ; TIME_DESC ;其中:time为二进制时间值,flag为二进制时间标志:1表示绝对时间,2表示相对时间,0表示错误。sTime写ASCII时间字符串。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录ABinaryTime long BinaryTime(char* sTime, TIME_DESC* bTime)BinaryTime函数将ASCII时间转换成二进制时间。参数sTime读ASCII时间字符串。bTime写二进制时间数据结构。TIME_DESC数据结构格式:typedef struct long time ; TIME_DESC ;其中:time为二进制时间值,flag为二进制时间标志:1表示绝对时间,2表示相对时间,0表示错误。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录Amit long mit(long viewID) ;mit函数向实时数据平台提交实时数据视图中的数据。参数viewID读实时数据视图标识。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录ACreateAlarmView long CreateAlarmView(long& viewID, char* database, long area, long unit, long viewAttr, long count)CreateAlarmView函数建立报警记录视图。参数viewID写报警记录视图标识。database读数据库名,单数据库系统为NULL。area读区域号,0表示所有区域。unit读单元号,0表示所有单元。viewAttr读视图属性,用如下符号表示:VIEW_ATTR_STATIC静态视图缺省值);VIEW_ATTR_ACTIVE动态视图;VIEW_ATTR_STANDARD标准视图,数据来自系统数据库缺省值);VIEW_ATTR_SIMULATE仿真视图,数据来自仿真数据库。count(读) 视图报警中记录个数。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录ACreateDataViewlong CreateDataView(long& viewID, char* database, long viewAttr, char* dataDesc, long count) 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项自动建成。CreateDayStaView long CreateDayStaView(long& viewID, char* database, long viewAttr, char* dataDesc, long tagCount, char* endTime, long count) ;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,意义为“年:月:日-时:分:秒,表示视图数据完毕时间为某一确定时间;2、 当前时间,用NULL时表示;3、 相对时间,时间格式为“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处理,即日统计数据视图中最后一个数据是当日前一天的数据。CreateEventView long CreateEventView(long& viewID, char* database, long area, long unit, long viewAttr, long count)CreateEventView函数建立事件记录视图。参数viewID写事件记录视图标识。database读数据库名,单数据库系统为NULL。area读区域号,0表示所有区域。unit读单元号,0表示所有单元。viewAttr读视图属性,用如下符号表示:VIEW_ATTR_STATIC静态视图缺省值);VIEW_ATTR_ACTIVE动态视图;VIEW_ATTR_STANDARD标准视图,数据来自系统数据库缺省值);VIEW_ATTR_SIMULATE仿真视图,数据来自仿真数据库。count(读) 视图中记录个数。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录ACreateHisView long CreateHisView(long& viewID, char* database, long viewAttr, char* dataDesc, long tagCount, char* endTime, char* spanTime, long count) 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的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录ACreateHourStaView long CreateHourStaView(long& viewID, char* database, long viewAttr, char* dataDesc, long tagCount, char* endTime, long count) CreateHourStaView函数建立时统计数据视图。参数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,意义为“天-时:分:秒表示视图数据完毕时间为当前时间向前减去所表示的相对时间。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处理,即时统计数据视图中最后一个数据是当日前一小时的数据。CreateTagAlarmView long CreateTagAlarmView(long& viewID, char* database, char* tagName, long viewAttr, long count)CreateTagAlarmView函数建立单点报警记录视图。参数viewID写报警记录视图标识。database读数据库名,单数据库系统为NULL。tagName读视图中的一个TAG点名称,字符串指针。因为仅有PV值有报警数据,这里也可写成: <点名>.PV。viewAttr读视图属性,用如下符号表示:VIEW_ATTR_STATIC静态视图缺省值);VIEW_ATTR_ACTIVE动态视图;VIEW_ATTR_STANDARD标准视图,数据来自系统数据库缺省值);VIEW_ATTR_SIMULATE仿真视图,数据来自仿真数据库。count(读) 视图中记录个数。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录ACreateTagEventView long CreateTagEventView(long& viewID, char* database, char* tagDesc, long viewAttr, long count)CreateTagEventView函数建立单点事件记录视图。参数viewID写事件记录视图标识。database读数据库名,单数据库系统为NULL。tagDesc读视图中的一个TAG点参数描述,字符串指针。如果仅写TAG点名称,取这个TAG点所有参数发生的所有事件;如果写成: <TAG点名称>.<参数名称>,取指定TAG点指定参数发生的所有事件。viewAttr读视图属性,用如下符号表示:VIEW_ATTR_STATIC静态视图缺省值);VIEW_ATTR_ACTIVE动态视图;VIEW_ATTR_STANDARD标准视图,数据来自系统数据库缺省值);VIEW_ATTR_SIMULATE仿真视图,数据来自仿真数据库。count(读) 视图中记录个数。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录ADeleteView long DeleteView(long viewID) DeleteView函数删除数据视图。参数viewID读数据视图标识。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录AEnableUserWriteDevicelong EnableUserWriteDevice(long onOff)EnableUserWriteDevice函数设置用户级的允许/禁止回送现场设备数据控制开关。参数onOff读控制开关,控制开关的开关状态用如下符号表示:ENABLE_WRITE_DEVICE开状态,即允许回送现场设备数据;DISABLE_WRITE_DEVICE关状态,即禁止回送现场设备数据;返回值指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录A说明缺省情况下,每个用户被设成禁止回送现场设备状态,每个视图被设成允许回送现场设备状态但只有用户和视图都被设成允许回送现场设备状态数据才能真正回送。如果某个用户被设成允许回送现场设备状态,如此它所建的每个视图缺省情况下均被设成允许回送现场设备状态,此时进展视图提交的话就会将数据回送到下位机或现场设备。这时候也可以把具体某一个视图设成禁止回送现场设备状态。参见 EnableViewWriteDeviceEnableViewWriteDevicelong EnableViewWriteDevice(long viewID, long onOff)EnableViewWriteDevice函数设置视图级的允许/禁止回送现场设备数据控制开关。参数viewID读实时数据视图标识。onOff读控制开关,控制开关的开关状态用如下符号表示:ENABLE_WRITE_DEVICE开状态,即允许回送现场设备数据;DISABLE_WRITE_DEVICE关状态,即禁止回送现场设备数据;返回值指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录A说明缺省情况下,每个用户被设成禁止回送现场设备状态,每个视图被设成允许回送现场设备状态但只有用户和视图都被设成允许回送现场设备状态数据才能真正回送。如果某个用户被设成允许回送现场设备状态,如此它所建的每个视图缺省情况下均被设成允许回送现场设备状态,此时进展视图提交的话就会将数据回送到下位机或现场设备。这时候也可以把具体某一个视图设成禁止回送现场设备状态。参见 EnableUserWriteDeviceGetDatamitFlaglong GetDatamitFlag(long viewID, long dataID) GetDatamitFlag函数读实时数据视图中数据的提交标志,检测数据是否被提交。参数viewID读实时数据视图标识。dataID读) TAG点参数数据标识。返回值:1:数据被提交;0:数据未被提交;小于0的整数值:函数执行失败;注:函数执行失败原因可根据返回值参阅附录A参见 GetDataIDGetDatamitStatuslong GetDatamitStatus(long viewID, long dataID, long& mitStatus) GetDatamiStatus函数读实时数据视图中数据向实时数据库中提交后的状态,检测数据是否被提交到实时数据库中。参数viewID读实时数据视图标识。dataID读) TAG点参数数据标识。mitStatus写) 实时数据视图中数据向实时数据库中提交后的状态。可能的状态值与其意义如下: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说明缺省情况下,每个用户被设成禁止回送现场设备状态,每个视图被设成允许回送现场设备参见 GetDataIDGetDatamitTime long GetDatamitTime(long viewID, long dataID, char* sTime) GetDatamitTime函数读实时数据视图中数据的提交时间。参数viewID读实时数据视图标识。dataID读) TAG点参数数据标识。sTime写数据的提交时间,时间格式为“YYYY:MM:DD-HH:MM:SS,意义为“年:月:日-时:分:秒。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录A参见 GetDataIDGetDataExist long GetDataExist(long viewID, long dataID)GetDataExist函数检查实时数据视图中的TAG点参数在数据库中是否存在。参数viewID读实时数据视图标识。dataID读) TAG点参数数据标识。返回值:不小于1的整数值实时数据视图中的TAG点参数在数据库中存在;小于1的整数值实时数据视图中的TAG点参数在数据库中不存在;GetDataID long GetDataID(long viewID, char* dataDesc) ;GetDataID函数读实时数据视图中的数据标识。参数viewID 读实时数据视图标识。dataDesc读) 视图中存在的TAG点参数名称。返回值:指示TAG点参数的数据标识或函数执行状态不小于0的整数值TAG点参数的数据标识;小于0的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录AGetDataInt long GetDataInt(long viewID, long dataID, long& dat) GetDataInt函数读实时数据视图中的整型数据。参数viewID 读实时数据视图标识。dataID读) TAG点参数数据标识。dat写TAG点参数整型数据值。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录A参见 GetDataIDGetDataModifyFlaglong GetDataModifyFlag(long viewID, long dataID) GetDataModifyFlag函数读实时数据视图中数据的修改标志,检测数据是否被修改。参数viewID读实时数据视图标识。dataID读) TAG点参数数据标识。返回值:1:数据被修改;0:数据未被修改;小于0的整数值:函数执行失败;注:函数执行失败原因可根据返回值参阅附录A参见 GetDataIDGetDataModifyTime long GetDataModifyTime(long viewID, long dataID, char* sTime)GetDataModifyTime函数读实时数据视图中数据的修改时间。参数viewID读实时数据视图标识。dataID读) TAG点参数数据标识。sTime写数据的修改时间,时间格式为“YYYY:MM:DD-HH:MM:SS,意义为“年:月:日-时:分:秒。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录A参见 GetDataIDGetDataReal long GetDataReal(long viewID, long dataID, double& dat) GetDataReal函数读实时数据视图中的实型数据。参数viewID 读实时数据视图标识。dataID读) TAG点参数数据标识。dat写TAG点参数实型数据值。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录A参见 GetDataIDGetDataStatus long GetDataStatus(long viewID, long dataID)GetDataStatus函数读实时数据视图中数据的状态。参数viewID读实时数据视图标识。dataID读) TAG点参数数据标识。返回值:实时数据视图中数据的状态。参见 GetDataIDGetDataStr long GetDataStr(long viewID, long dataID, char* dat, long length) GetDataStr函数读实时数据视图中的字符型数据。参数viewID 读实时数据视图标识。dataID读) TAG点参数数据标识。dat写TAG点参数字符型数据值。length读) TAG点参数字符型数据值长度。返回值:指示函数执行状态:不小于1的整数值函数执行成功;小于1的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录A参见 GetDataIDGetDataStrLengthlong GetDataStrLength(long viewID, long dataID) GetDataStrLength函数读实时数据视图中的字符型数据长度数据字节数。参数viewID 读实时数据视图标识。dataID读) TAG点参数数据标识。返回值:指示字符型数据长度或函数执行状态;不小于0的整数值字符型数据长度;小于0的整数值函数执行失败;注:函数执行失败原因可根据返回值参阅附录A参见 GetDataIDGetDataTagmitFlaglong GetDataTagmitFlag(long viewID, char* tagName) GetDataTagmitFlag函数读实时数据视图中数据的提交标志,检测数据是否被提交。参数viewID读实时数据视图标识。tagName读) 视图中的一个TAG点参数的名称,字符串指针。格式为: <点名>.<参数名>.<细目名>。返回值:1:数据被提交;0:数据未被提交;小于0的整数值:函数执行失败;注:函数执行失败原因可根据返回值参阅附录AGetDataTagmitStatuslong GetDataTagmitStatus(long viewID, char* tagName, long& mitStatus) GetDataTagmiStatus函数读实时数据视图中数据向实时数据库中提交后的状态,检测数据是否被提交到实时数据库中。参数viewID读实时数据视图标识。tagName读) 视图中的一个TAG点参数的名称,字符串指针。格式为: <点名>.<参数名>.<细目名>。mitStatus写) 实时数据视图中数据向实时数据库中提交后的状态。可能的状态值与其意义如下: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

    注意事项

    本文(C接口函数参考手册范本.doc)为本站会员(李司机)主动上传,三一办公仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对上载内容本身不做任何修改或编辑。 若此文所含内容侵犯了您的版权或隐私,请立即通知三一办公(点击联系客服),我们立即给予删除!

    温馨提示:如果因为网速或其他原因下载失败请重新下载,重复下载不扣分。




    备案号:宁ICP备20000045号-2

    经营许可证:宁B2-20210002

    宁公网安备 64010402000987号

    三一办公
    收起
    展开