国家标准 GB/T34949一2017 实时数据库C语言接口规范 Cprvgramminglanguageinterfaeespetfieatinofreatimedatabase 2017-11-01发布 2018-05-01实施国家质量监督检验检疫总局发布国家标准化管理委员会国家标准
GB/34949一2017 目次前言范围 2 规范性引用文件 3 术语和定义缩略语概述接口描述约定实时数据库接口资源及连接管理 7.1资源初始化接口 7.2资源释放接口 7.3实时库连接接口 7.4实时数据库连接断开接口 8 测点管理 8.1测点名称是否存在检测接口 8.2枚举测点标识接口 8.3循环获取测点ID列表接口 8.4释放结果集资源接口 8.5根据测点名称获取单个测点标识接口 8.6根据测点名称列表获取多个测点标识接口 8.7根据测点标识获取单个测点属性接口 8.8根据测点名称获取单个测点属性接口 8.9根据测点标识列表批量获取测点属性接口 8.10根据测点名称列表批量获取测点属性接口 8.11批量新建测点接口 8.12修改单点测点属性接口 8.13批量修改测点属性接口 8.14根据测点标识删除单个测点接口 8.15根据测点名称删除单个测点接口 8.16根据测点标识批量删除测点接口 8.17根据测点名称批量删除测点接口 8.18搜索符合条件的测点接口数据写人 9.1写人单个测点的实时数据接口 9.2批量写人测点的实时数据接口 9.3批量写人具有相同测点标识的实时数据接口 9.4批量写人具有相同时间戳的实时数据
GB/T34949一2017 9.5写人单个测点某一时刻的历史数据接口 9.6批量写人测点的历史数据接口 9.7批量写人具有相同测点标识的历史数据接口 9.8批量写人具有相同时间戳的历史数据接口 9.9从历史数据中删除某个时间的数据接口 9.10从历史数据中删除某个时间段的数据接口 9.11修改单个历史数据接口 10数据查询 0.1读取单个测点的实时数据接口 10 0.2批量读取测点的实时数据接口 0.3读取单个测点某个时间的历史数据接口读取单个测点一段时间内的历史数据接口 10,4 循环获取结果集中的历史值数接口 10.5 12 0,6查询某一历史时刻的断面取值接 10.7读取单个测点一段时间内等间隔线性拟合后的历史数据接口 12 读取单个测点一段时间内等间隔阶梯拟合后的历史数据接口 12 10,8 数据统计 11 13 1.1查询单个测点在某个时间段内的统计数据接口 13 1.2根据过滤条件查询单个测点在某个时间内的统计数接口 13 附录A规范性附录数据类型 14 附录B(规范性附录错误码 19
GB/34949一2017 前言本标准按照GB/T1.1一2009给出的规则起草请注意本文件的某些内容可能涉及专利本文件的发布机构不承担识别这些专利的责任本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口本标准起草单位:江苏瑞中数据股份有限公司、电子技术标准化研究院、南京南瑞集团公司、上海麦杰科技股份有限公司本标准主要起草人:张珂璀、王远、季胜鹏、郑晓露、粟勇、史英杰、周淳、朱恒、蒋树嵩、毛海泉李贤慧、沈国辉周劲鹰、孟小凡、李莹、卫凤林、王笑、杨永军
GB/34949一2017 实时数据库C语言接口规范范围本标准规定了实时数据库C语言接口,涉及实时数据库通用接口的原型定义、输人参数和输出参数的数据类型以及接口调用的返回信息本标准适用于实时数据库接口的开发,应用系统与实时数据库集成的设计和开发可参照执行规范性引用文件下列文件对于本文件的应用是必不可少的凡是注日期的引用文件,仅注日期的版本适用于本文件凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件 GB/T15272一1994程序设计语言C 术语和定义下列术语和定义适用于本文件 3.1 实时数据库real-timedatabase -种专门用于处理和存储随时间变化的值和状态量的数据库 3.2 测点measurementpoint 实时数据库中时间序列数据的一个存储单元注，测点数据可能直接源自采集设备,也可能源自非采集设备,如统计值等计算量 3.3 质量码(状态码qualitycde 描述数据质量属性的一组代码,每组代码共32位 3,4 实时值currentvale 测点采集的最新值,即实时数据库中测点存储的距当前时间最近的值每个实时值包括时间戳、数据值和质量码三部分 3.5 历史值historicalvalue 测点采集的历史值,即实时数据库中测点存储的非最新值历史数据由实时数据沉淀形成,每个历史值包括时间戳、数据值和质量码三部分 3.6 结果集resultset 调用实时数据库通用接口返回得到的数据结果集合,结果中数据的格式由查询的内容定义缩略语下列缩略语适用于本文件
GB/T34949一2017 API;应用编程接口ApplicationProgramminglnterface) RTDBUAPI;实时数据库通用接口RealtimeDatabase'sUniversalAPD UTC;协调世界时(CoordinatedUniversalTime) 5 概述本标准根据实时数据库接口功能的不同,对接口进行分组描述,包括以下5个部分实时数据库访问接口资源及连接管理;实时数据库接口的资源初始化及释放,连接的初始化及 a) 释放测点管理:对测点的增加、删除、修改和查询.以及对测点属性的查询和修改 b 数据写人;向测点中写人数据值; c 数据查询;查询测点数据值 d 数据统计;统计测点一段时间内的数据 6 接口描述约定本标准按照以下4种元素对实时数据库编程接口进行描述: 接口原型:由接口的返回类型、接口名和输人,输出参数列表组成; aa b)说明:对接口功能的简单描述; 参数;指明调用接口的输人参数或者输出参数情况,输人参数和输出参数的具体含义见附录A 返回;指明接口调用正常的返回值和接口调用异常出现的错误返回值,统一称为错误码,具体 d 含义见附录B 实时数据库接口资源及连接管理 7.1资源初始化接口 RTDBRETcODERTDB_Init(constRTDB_VOID*pPara) 说明:初始化RTDBUAPI使用的资源如果接口需要调用者在调用其他接口前进行显式的资源初始化,可在此接口内实现资源初始化参数:pPara为输人的参数,具体含义由实时库厂商自行定义返回:错误码,可为:U_ERR_OK,U_ERR_OTHERS 7.2资源释放接口 RTDB_RETCODERTDB_Dispose( 说明;释放RTDBUAPI使用的资源如果接口设计者在不再使用实时数据库接口前需要进行显式的资源释放,可在此接口内实现资源释放参数;无返回错误码,可为:U_ERR_OK,U_ERR_OTHERS 7.3实时库连接接口 RTDB_HANDLERTDB_Conneect(consRTDB_CHAR8关szAddr，RTDB_UINTl6uiPort RTDB_CHAR8关szServerName，const RTDB_CHAR8*szUserName，const tRTDB_CHAR8 const
GB/34949一2017 sxPassword，RTDB_BooL.32bTimesyme，RTDB_BooL.32 bReconnected，RTDBINT32 lnterval，RTDB_INT32IConneetIimes，cont tRTDB_VOID*pExtPara) 说明:连接实时数据库在调用需要输人RTDB_HANDLE类型参数的接口前,应通过调用此接口获得RTDB_HANDLE 参数;szAddr为输人参数,表示主数据库服务器的IP地址;uiPort为输人参数,表示实时数据库服务端口号;szServerName 为输人参数,表示次级数据库服务器的机器名称;szUser Name为输人参数,表示连接实时数据库服务使用的用户名;szPassword为输人参数,表示用户名对应的密码;bTimeSync为输人参数，表示是否与服务器时间同步; bReconnected为输人参数,表示是否进行自动重连;Ilnterval为输人参数,表示两次重连之间的时间间隔;IConnectTimes为输人参数,表示重连次数;pExtPara为输人参数表示扩展参数返回:正常情况下,返回大于0的连接句柄;否则,返回错误码，可为:UERR_CONN_NET- WORK,U_ERR_CONN_SERVER_NONE,U_ERR_CONN_ERROR,U_ERR_CONN BL.oCKED,U_ERR_cONLIMIT.U_ERR_cONNEXIsT,URRSEcURITY FAILURE,U_ERR_OTHERS 7.4实时数据库连接断开接口 RTDBRETcoDERTDB_DisConnect(RTDB_HANDLEhHandley 说明:断开同实时数据库服务器的连接调用此接口将导致输人的RTDB_HANDLE失效参数;hHlandle为输人参数,表示连接句柄返回;错误码,可为U_ERR_OK,U_ERR_cON_HANDLE,U_ERR_cON_DIscON- NEcTED,U_ERR_OTHERs. 测点管理 8.1测点名称是否存在检测接口 RTDB_RETcoDERTDB_PointNameExists(RTDB_HANDLEhHandle，constTAG_NAME tag 说明;检查是否存在指定名称的测点参数;hHandle为输人参数,表示连接句柄;tag为输人参数,表示测点名称返回;错误码,可为U_ERR_OK,U_ERR_cONN_HANDLE，U_ERR_OPT_POINT NONE,U_ERR_OTHERS. 8.2枚举测点标识接口 RTDB_HRECORDSETRTDB_EnumPointIDs(RTDB_HANDLEhHandle) 说明:枚举所有的测点标识,并返回结果集句柄作为接口DB_GetNextPointlD的输人参数心此接口配合DB_G extPointlID使用 et 参数:hHandle为输人参数,表示连接句柄返回;如果正常,返回大于0的结果集句柄;否则,返回错误码,可为:U_ERR_CONN_HAN DLE,U_ERR_OPT_POINT_NONE,U_ERR_HREcORDSET_MALL.0cC_MEM,U. ERR_OTHERS
GB/T34949一2017 8.3循环获取测点ID列表接口 RTDB_RETCODERTDB_GetNextPointlDRTDB_HANDLEhHandle，RTDB_HIRECORDSET hRecordset，RTDB_INT32关start，RTDB_INT32*pts，RTDB_INT32关 count 说明:循环获取结果集中的测点ID列表此接口需配合RTDB_EnumPointIDs,RTDBRe laeaseHRecordset使用参数:hHandle为输人参数,表示连接句柄;hRecordset为输人参数,表示结果集句柄;start作为输人参数时表示结果集的开始位置,作为输出参数时表示再次调用该接口时结果集的取数位置,第一次调用该接口时,设置该值为0;pts为输出参数,表示测点标识列表; count为测点标识个数,作为输人参数时,表示测点标识数组的大小,作为输出参数时表示返回的实际测点标识数目返回、错误码,可为U_ERR_coNN_HANDLE.U_ERR_HREcoRDsET _ALL. GET U_ERRHRECORDSET_NOT_GET_ALL,U_ERR_HRECORDSETUNDEFINED U_ERRRECORDSET_MATCHERR,UERR_0THERS 8.4释放结果集资源接口 RTDB_RETcoDERTDB_RedleaseHRecordset(RTDB_HANDLEhHandle，RTDB_HREcoRD sEThRecordset) 说明:释放结果集所使用的资源结果集需要使用一定的硬件资源,接口调用者申请获取到- 个有效结果集后,会得到一个结果集句柄,通过结果集句柄循环获取结果集内的数据当结果集内的数据全部被获取后,接口应自动释放该结果集占用的资源;结果集内的数据尚未被全部获取时,接口可根据需要决定是否释放该结果集使用的资源,接口调用者可通过调用本接口主动要求释放该结果集所使用的资源结果集所使用的资源被释放后,该结果集即不存在,对应的结果集句柄也应失效此接口配合DB_GetINextPointID， RTDBQuerylnterpoValues,RTDBQueryl.adderValues使用参数:hHandle为输人参数,表示连接句柄;hRecordset为输人参数,表示结果集句柄返回错误码,可为;U_ERR_OK，U_ERR_HREcORIDSET_UNDEFINED, U_ERR_cONN_HANDLE,U_ERR_OTHERs 8.5根据测点名称获取单个测点标识接口 RTDB_RETcODERTDB_GetPointDByName(RTDB_HANDLEhHandle，constTAG_NAME tag，RTDB_INT32*pt) 说明;根据测点名称获取单个测点标识参数;hHandle为输人参数,表示连接句柄;tag为输人参数,表示测点名称;pt为输出参数,表示测点标识返回;错误码,可为:U_ERR_OK,U_ERR_OPT_POINTNONE. U_ERR_cONN_HANDLE,U_ERR_OTHERS. 8.6根据测点名称列表获取多个测点标识接口 RIDB_RE:TcoDERIDB_GetPontslDByNames(RTDB_HANDLEhHandleconstTAG. NAME关tags，RTDB_INT32关count，RTDB_INT32关pts，RTDB_INT32+ errors 说明;根据测点名称列表获取多个测点标识参数:hHandle为输人参数,表示连接句柄;tags为输人参数,表示测点名称数组;count为测
GB/34949一2017 点个数,作为输人参数时表示要获取的测点标识数目,作为输出参数时表示成功获得的测点标识数目;pts为输出参数,表示测点标识数组;errors为输出参数,表示错误码数组,和每个输人的测点名称对应,包括:U_ERR_OK,U_ERR_OPT_POINT_NONE,U ERR_OTHERS 返回;错误码,可为:U_ERR_OK,U_ERR_cONN_HANDLE,U_ERR_0THERS. 8.7根据测点标识获取单个测点属性接口 RTDB_RETcODERTDB_GetPointPropertyByID(RTDB_HANDLEhHandle，RTDB_INT32pt. PointField*pPf 说明:根据测点标识获取单个测点属性参数;hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;pP为输出参数,表示测点属性返回返回错误码,包括.U_ERR_OK.,U_ERR_cONN_HANDLE.,U_ERR_OPT_PoINT NONE,U_ERROTHERS 8.8根据测点名称获取单个测点属性接口 RTDBRETcoDERTDB_GetPointPropertyByName(RTDB_HANDLEhHandle，constTAG NAME'tag，PointFidld*pPr 说明:根据测点名称获取单个测点属性参数:hHandle为输人参数,表示连接句柄;tag为输人参数,表示测点标识;pPf为输出参数表示测点属性返回;返回错误码,包括:U_ERR_oK,U_ERR_cONN_HANDLE,U_ERR_oPT_PoINT NONE,U_ERR_OTHERs 8.9根据测点标识列表批量获取测点属性接口 RTDB_RETcODERTDB_GetPointsPropertyByIDs(RTDB_HANDLEhHandle，constRTDB NT32*pts，RTDB_INT32*count，PointFied*pPfs，RTDBINT32关errors) 说明:根据测点标识列表批量获取测点属性参数;hHandle为输人参数,表示连接句柄;pts为输人参数,表示测点标识数组;count为测点个数,作为输人参数时表示要获取的测点标识数目,作为输出参数时表示成功获得的测点标识数目;pP!s为输出参数,表示测点属性数组;errors为输出参数,表示误码数组,和每个输人的测点名称对应,包括:U_ERR_OK,U_ERR_OPT_POINT_NONE,U_ERR OTHERs 返回;错误码,可为U_ERR_OK,U_ERR_CONN_HANDLE,U_ERR_OTHERS 8.10根据测点名称列表批量获取测点属性接口 RTDBRETcODERTDB_GetPointsPropertyByNames(RTDB_HANDLEhHandle,constTAG NAME关 tags，RTDB_INT32*eount， PoumaFiald”pP!Is，RTBINT32 errors 说明;根据测点名称列表批量获取测点属性参数:hHandle为输人参数,表示连接句柄;tags为输人参数,表示测点名称数组;count为测点个数,作为输人参数时表示要获取的测点标识数目,作为输出参数时表示成功获得的测点标识数目;pPs为输出参数,表示测点属性数组;errors为输出参数,表示误码数组，和每个输人的测点名称对应,包括;U_ERR_OK,U_ERR_OPT_POINT_NONE,U
GB/T34949一2017 ERR_OTHERS. 返回:错误码,可为:U_ERR_OK,U_ERR_cONN_HANDLE,U_ERR_OTHERS 8.11批量新建测点接口 RTDB_RETcODERTDB_InsertPointRTDB_HANDLEhHandle，RTDB_INT32" count， PointField*pPfs，RTDB_INT32* errrS 说明:批量新建测点参数hHandle为输人参数,表示连接句柄;pPfs为输人参数,表示测点属性,如果是由实时库分配测点的ID,那么,该接口中测点属性字段中测点ID是不需要赋值的;eount为测点个数先作为输人参数表示要添加的测点数目,后作为输出参数表示成功添加的测点数目;errors为输出参数,表示错误码数组,和每个输人的测点对应,取值包括;U_ERR OK,U_ERR_OPT_POINT_NAME_EXIST,U_ERR_0THERS 返回:错误码,可为:U_ERR_OK,U_ERR_CONN_HANDLE.,U_ERR_OTHERS 8.12修改单点测点属性接口 RTDBRETCODERTDBUpdatePoint(RTDBHANDLEhHandle，constPointField关pPf 说明:修改单点测点属性参数;hHandle为输人参数,表示连接句柄;pPr为输出参数,表示测点属性返回:错误码,可为:U_ERR_OK,U_ERR_cON_HANDLE，U_ERR_OPT_PONT NONE,U_ERR_oTHERs 8.13批量修改测点属性接口 RTDBRETcoDERTDB_UpdatePoints(RTDB_HANDLEhHandle，constPointField*pPHs RTDB_INT32翼count，RTDB_INT32弟errors) 说明;批量修改测点属性参数:hHandle为输人参数,表示连接句柄;pPfs为输出参数,表示测点属性数组;count为测点个数,作为输人参数时表示要添加的测点数目,作为输出参数时表示成功添加的测点数目;errors为输出参数,表示错误码数组,和每个输人的测点对应,包括:U_ERR_OK U_ERR_OPT_POINT_NAME_EXIST.U_ERR_OTHERs 返回错误码,可为;U_ERR_OK,U_ERR_cONN_HANDLE,U_ERR_OTHERS 8.14根据测点标识删除单个测点接口 RTDB_RETcODERTDB_RermovePointByID(RTDB_HANDLEhHandle，RTDB_INT32pt) 说明根据测点标识删除单个测点参数:hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识返回;错误码,可为:U_ERR_OK,U_ERR_CONN_HANDLE，U_ERR_OPT_POINT NONE,U_ERR_OTHERS 8.15根据测点名称删除单个测点接口 RTDB_RETcoDERTDB_RemovePointByNane(RTDB HANDLEhHandle，constTAG NAMEtag) 说明根据测点名称删除单个测点参数;hHandle为输人参数,表示连接句柄;tag为输人参数,表示测点名称
GB/34949一2017 返回;错误码,可为;U_ERR_OK,U_ERR_cONN_HANDLE，U_ERR_OPT_POINT NONE,U_ERR_0THERS. 8.16根据测点标识批量删除测点接口 RTDBRETcODERTDB_RemovePointByIDs(RTDB_HANDLEhHandle，constRTDB_INT32 pts，RTDB_INT32关 count， RTDB_INT32 errOrs 说明:根据测点标识批量删除测点参数,hHandle为输人参数,表示连接句柄1pts为输人参数,表示测点标识数组eont为测点个数,作为输人参数时表示要获取的测点标识数目,作为输出参数时表示成功获得的测点标识数目;errors为输出参数,表示错误码数组,和每个输人的测点对应,包括:U ERR_OK,U_ERR_OPT_POINT_NAME_EXIST,U_ERR_0THERS. 返回:错误码,可为U_ERR_OK,U_ERR_CONN_HANDLE,U_ERR_OTHERs 8.17根据测点名称批量删除测点接口 RTDB_RETcoDERTDB_RemovePointByNames(RTDB_HANDLEhHandle，constTAG NAME*tags，RTDB_INT32*count，RTDB_INT32关errors) 说明:根据测点名称批量删除测点参数:hHandle为输人参数.表示连接句柄;tags为输人参数.表示测点名称数组;count为测点个数,作为输人参数时表示要获取的测点标识数目,作为输出参数时表示成功获得的测点标识数目;errors为输出参数,表示错误码数组,和每个输人的测点对应.包括:U ERR_OK,U_ERR_OPT_POINT_NAME_EXIST,U_ERR_OTHERS 返回:错误码,可为:U_ERR_OK,U_ERR_CONN_HANDLE,U_ERR_OTHERS 8.18搜索符合条件的测点接口 RTDB_HRECORDSETRTDB_SearchEx(RTDB_HANDLEhHandle，consRTDB_CHAR8" tagmask，constRTDB_CHAR8*source，constRTDB_CHAR8关unit，constRTDB_CHAR8养 desc,consRTDB_CHAR8*descex,sORT_MODEmode) 说明:搜索符合条件的测点,返回测点标识结果集句柄,使用测点名时支持通配符此接口配合RTDB_GetNextPointIDs,RTDB_RelaeaseHRecordset使用参数:hHandle为输人参数,表示连接句柄;tagmask为输人参数,表示测点名称掩码,支持 ”和“?”通配符,缺省设置为" source为输人参数,表示数据源集合,字符串中的每个字符均表示一个数据源,空字符串表示不用数据源作搜索条件,缺省设置为空;unit 为输人参数,表示测点工程单位的子集,工程单位中包含该参数的测点均满足条件,空字符串表示不用工程单位作搜索条件,缺省设置为空;desc为输人参数,表示测点描述的子集,描述中包含该参数的测点均满足条件,空字符串表示不用描述作搜索条件,缺省设置为空;descex为输人参数,表示测点扩展描述的子集,扩展描述中包含该参数的测点均满足条件,空字符串表示不用扩展描述作搜索条件，缺省设置为空;mode为输人参数,表示搜索结果的排序模式返回:如果正常,返回大于0的结果集句柄;否则,返回错误码,可为:U_ERR_cONN_HAN- DLE,U_ERR_OTHERS 数据写入 g.1写入单个测点的实时数据接口 RTDBRETcODERTDBPutSnapShot(RTDB_HANDLEhHandle constTAGVAL *pTagVal)
GB/T34949一2017 说明;写人单个测点的实时数据参数;hHandle为输人参数,表示连接句柄;pTagVal为输人参数,表示点值返回;错误码,可为: U_ERR_OK,U_ERR_cONN_HANDLE,U_ERR_OPT_POINT_NONE U_ERR_oPT_POINT_PROPERTY_ERROR.U_ERR_OTHERs 9.2批量写入测点的实时数据接口 RTDBRETCODERTDB_PutSnapShots(RTDB_HANDLEhHandle，constTAGVAL pTagVals RTDBINT32关count，RTDB_INT32 errors 说明:批量写人测点的实时数据参数;hHandle为输人参数,表示连接句柄;pTagVals为输人参数,表示点值数组;count作为输人参数时表示pTagVals的长度,作为输出参数时表示成功写人的实时值个数;erors 为输出参数,表示错误码数组,和每个输人的测点对应,包括:U_ERR_OK,U_ERR cONN_HANDLE，U_ERR_OPT_PoINT_NoNE,U_ERR_OPT_POINT PROPERTYERROR,UERR_OTHERS 返回错误码,可为:U_ERR_OK,U_ERR_CONN_HANDLE,U_ERR_OTHERS g.3批量写入具有相同测点标识的实时数据接口 pShotslBySameID(RTDB_HANDLEhHanmdle，RTDB_INT32 RTDB_RETcODERTDB_PutSnaps pt,constTAGVAL关pTagVals，RTDB_INT32*count，RTDB_INT32关errors 说明;批量写人具有相同测点标识的实时数据参数:hHIandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;pTagVals为输人参数,表示点值数组,由于测点值的测点标识是相同的,所以测点值字段中测点标识属性不需要赋值;count作为输人参数时表示pTagVals的长度,作为输出参数时表示成功写人的实时值个数;erors为输出参数,表示错误码数组,和每个输人的测点对应,包括:U ERR_oK.U_ERR_coNN_HANDLE，U_ERR_oOPT_POINT_NONE，U_ERR_OPT POINT_PROPERTY_ERROR，U_ERR_OTHERs. 返回;错误码,可为;U_ERR_OK,U_ERR_CONN_HANDLE,U_ERR_OPT_POINT NONE,U_ERR_OPT_POINT_PROPERTY_ERRoR,U_ERR_oTHERS g.4批量写入具有相同时间戳的实时数据 RTDB_RE:TcoDERTDB_PutsnapShotsBySameTimeStamp(RTDB_HANDLEhHandle，const HIP_TIimeStamp来TimeSta amp,constTAGVAL*pTagVals，RTDBINT32" count， RTDB_INT32 errorS 说明;批量写人具有相同时间戳的实时数据参数;hHandle为输人参数,表示连接句柄;TimeStamp为输人参数,表示时间戳;pTagVal 为输人参数,表示点值数组,由于测点值的测点标识是相同的,所以测点值字段中测点标识属性不需要赋值;count为输人参数时表示pTagVal、的长度,作为输出参数时表示成功写人的实时值个数;erors为输出参数,表示错误码数组,和每个输人的测点对应包括U_ERR_OK,U_ERR_CONN_HANDLE,U_ERR_OPT_POINT_NONE,U_ERR OPT_POINT__PROPERTY_ERROR,U_ERR_OTHERS 返回错误码,可为U_ERR_OK,U_ERR_CONN_HANDLE，U_ERR_OTHERS
GB/34949一2017 9.5写入单个测点某一时刻的历史数据接口 RTDB_RETCODERTDB-PutSingleValueRTDB_HANDLEhHandle，constTAGVAL pTagVal 说明:写人单个测点某一时刻的历史数据参数:hHandle为输人参数,表示连接句柄;pTagVal为输人参数,表示点值返回;错误码，可为:U_ERR_OK,U_ERR_cONN_HANDLE，U_ERR_OPT_POINT NONE,U_ERR_OPT_POINT_PROPERTY_ERROR,U_ERR_OTHERS. 9.6批量写入测点的历史数据接口 RTDB_RETCODERTDB_PutArchivedValues(RTDB_HANDLEhHandle，constTAGVAL* pTagVals，RTDB_INT32*count，RTDB_INT32*errors) 说明批量写人测点的历史数据参数:hHandle为输人参数,表示连接句柄;pTagVals为输人参数,表示点值数组;count作为输人参数时表示pTaEVal、的长度,作为输出参数时表示成功写人的历史值个数;err rOrS 为输出参数,表示错误码数组，和每个箱人的测点对应,包括.U_ERR_OK,U_ERR OPT_POINT_NONE,U_ERRoPT_POINT coN_HANDLE,U_ERR- PROPERTY_ERRoR,U_ERR_oTHERs 返回:错误码,可为U_ERR_OK,U_ERR_cONN_HANDLE,U_ERR_OTHERs 9.7批量写入具有相同测点标识的历史数据接口 RTDB_RETcoDERTDB_PutArchivedValuesBySamelD(RTDB_HANDLEhHandle，RTDB NT32pt，constTAGVAL*pTagVals，RTDB_INT32*count，RTD)B_INT32*errors) 说明;批量写人具有相同测点标识的历史数据参数hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;pTagVals为输人参数,表示点值数组,由于测点值的测点标识是相同的,所以测点值字段中测点标识属性不需要赋值;count作为输人参数时表示pTagVal、的长度,作为输出参数时表示成功写人的历史值个数;errors为输出参数,表示错误码数组,和每个输人的测点对应,包括 U ERR_OK,U_ERR_cONN_HANDLE,U_ERR_OPT_POINT_NONE,U_ERR_OPT POINT_PROPERTY_ERROR,U_ERR_OTHERs 返回;错误码,可为;U_ERR_OK,U_ERR_cONN_HANDLE，U_ERR_OPT_POINT NONE,U_ERR_OPT_POINT_PROPERTY_ERROR,U_ERR_OTHERS 9.8批量写入具有相同时间戳的历史数据接口 RTDB_RETcODERTDB_PutArchivedValuesBySameTimeStamp(RTDB_HANDLEhHandle constHP_TimeStamp×TimeStamp，constTAGVAL*pTagVals，RTDB_INT32*count，RTDB NT32*errors) 说明;批量写人具有相同时间戳的历史数据参数;hHandle为输人参数,表示连接句柄;TimeStamp为输人参数表示时间戳;pTagVals 为输人参数,表示点值数组,由于测点值的测点标识是相同的,所以测点值字段中测点标识属性不需要赋值;count作为输人参数时表示pTagVals的长度,作为输出参数时表示成功写人的历史值个数;erors为输出参数,表示错误码数组,和每个输人的测点对应包括.U_ERR_OK,U_ERR_cONN_HANDLE,U_ERR_OPT_POINT_NONE,U
GB/T34949一2017 ERR_OPTPOINT_PROPERTY_ERROR,U_ERR_OTHERS. 返回;错误码,可为:U_ERR_OK,U_ERR_cONN_HANDLE,U_ERR_oTHERS. 9.9从历史数据中删除某个时间的数据接口 RTDB_RETcCOoDERTDB_RemoveVaue(RTDB_HANDLEhHandle，RTDB_INT32pt，const HIP_TimeStamp关datatime) 说明.从历史数据中剩除某个时间的数据参数;hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;datatinme为输人参数,表示时间戳返回;错误码，可为;U_ERR_oK,U_ERR_coNN_HANDLE,U_ERR_OPT_PoINT NONE,U_ERR_OPT_POINT_PROPERTY_ERROR,U_ERR_OTHERSs g.10从历史数据中删除某个时间段的数据接口 RTDB_RETcODERTDB_RemoveValues(RTDB_HANDLEhHandle，RTDB_INT32pt，const endtime HP_TimeStamp*startime，constHP_Tim mmeStamp关说明:从历史数据中删除某个时间段的数据参数:hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;starttime为输人参数,表示起始时间戳;endtime为输人参数,表示结束时间戳返回:错误码，可为:U_ERR_OK,U_ERR_CONN_HANDLE,U_ERR_OPT_POINT NONE,U_ERR_OPT_POINT_PROPERTY_ERROR,U_ERR_OTHIERS 9.11修改单个历史数据接口 RTDB_RETcODERTDBReplaceValueRTDB_HANDLEhHandle，constTAGVAL" pTagVal 说明;修改单个历史数据参数:;hHandle为输人参数,表示连接句柄;pTagVal为输出参数,表示点值,如果测点该历史时刻有值,则替换,如果点该历史时刻无值,则写人新值返回:错误码,可为:U_ERR_OK,U_ERR_cONN_HANDLE.U_ERR_OPT_POINT NONE,U_ERR_OPT_POINT_PROPERTY_ERROR,U_ERR_0THERS 10数据查询 0.1读取单个测点的实时数据接口 RTDBRETcoDERTDB_GetSnapShotRTDB_HANDLEhHandle，RTDB_INT32pt， TAGVAL”pTugVal 说明;读取单个测点的实时数据参数;hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;pTagVal为输出参数,表示点值返回;错误码,可为:U_ERR_OK,U_ERR_cONN_HANDLE，U_ERR_OPT_POINT NONE.U_ERR_OPT_PONT_PROPERTY_ERROR,U_ERR_OTHERS 0.2批量读取测点的实时数据接口 RTDB_RETcODERTDB_GetSnapShotsRTDB_HANDLEhHandle,RTDB_INT32pt，const 10
GB/34949一2017 TAGVAL*pTagVals,RTDB_INT32*count,RTDB_INT32州 errors 说明:批量读取测点的实时数据参数:hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识数组;pTagVal为输出参数,表示点值数组,由于测点值的测点标识是相同的,所以测点值字段中测点标识属性不需要赋值;count作为输人参数时表示pTagVal的长度,作为输出参数时表示成功读取的实时值个数;errors为输出参数,表示错误码数组,和每个输人的测点标识对应包括;U_ERR_oK.U_ERR_OPT_rPoINT_NONE.,U_ERR_oPT_rOINT PROPERTY_ERROR,U_ERR_OTHERs 返回:错误码,可为:U_ERR_OK,U_ERR_CONN_HANDLE,U_ERR_OTHERS 10.3读取单个测点某个时间的历史数据接口 RTDB_RETcODERTDB_GetSingleValue(RTDB_HANDLEhHandle，RTDB_INT32pt，const HIP -TimesSiamp TimeSamp constTAGVAL*pTagVals) 说明读取单个测点某个时间的历史数据参数:hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;TimeStamp 为输人参数,表示时间戳;pTagVals为输出参数,表示点值 R_oK,U_ERR_cONN_HANDLE,U_ERR_oPT_P(oINT 返回错谈码,可为U_ERR NONE,U_ERR_oPT_ARCHIVE_NONE,U_ERR_OPT_H1ST_NONE，U_ERR OTHERs 10.4读取单个测点一段时间内的历史数据接口 RTDB_HREcoRDsETRTDB_QueryArchivedValues(RTDB_HANDLEhHandle，RTDB NT32pt.constHPTimeStamp*lIStartTimme，constHP_TimeStamp*IEndTimme) 说明;读取单个测点一段时间内的历史数据,并返回结果集句柄此接口与RTDB_GetNex Values,RTDBReleaseHRecordset配合使用参数:hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;IStartTime为输人参数,表示查寻起始时间戳;IEndTime为输人参数,表示查询结束时间戳返回:如果正常,则返回大于0的结果集句柄;否则,返回错误码,可为 U_ERR_cONNN_HANDLE,U_ERR_OPT_POINT_NONE,U_ERR_OPT_ARCHIVE _NONE. U_ERR_OPT_HIST_NONE,U_ERR_HREcORDsET_MALLOc_MEM.U_ERR OTHERs 0.5循环获取结果集中的历史值数接口 RTDB_RETcODERTDB_GetNextValues(RTDB_HANDLEhHandle，RTDB_HREcORDSET hReordset，HP_TimesStamp ISiartTime，TAGVAL”pTagVal，RTDB_INT32”conn 说明:循环获取结果集中的历史值数此接口配合RTDB_QueryInterpoValue,RTDB QueryLadderValues使用参数:hHandle为输人参数,表示连接句柄;hRecordset为输人参数,表示结果集句柄;IStart Time为查寻起始时间截,作为输人参数时表示查询的起始时间,作为输出参数时表示下一次查询的起始时间;pTagVals为输出参数,表示点值数组;coun作为输人参数时表示测点值结构体数组的大小,作为输出参数时表示本次调用该AP返回的数据的实际数目 1
GB/T34949一2017 返回;错误码,可为:U_ERR_CONN_HANDLE,U_ERR_HIREcORDSET_GET_ALL,U ERR_HRECORDSET_NOT_GET_ALL,U_ERR_HREcORDSET_UNDEFINED，U ERR_REcORDSET_MATCH_ERR，U_ERR_OTHERs 10.6查询某一历史时刻的断面取值接口 RTDB_RETcoDERTDB_Getsections(RTDB_HANDLEhHandle，constRTDB_INT32*pts onstHIP_TimeStamp头TimeStamp，TAGVAL*pTagVals，RTDB_INT32*count，RTDB_INT32 errorS 说明;查询某一历史时刻的断面取值参数:hHandle为输人参数,表示连接句柄;pts为输人参数,表示测点标识数组;TimeStamp 为输人参数,表示时间戳;pTagVals为输出参数,表示点值数组;count作为输人参数时表示pTagVals的长度,作为输出参数时表示成功读取的历史值个数;errors为输出参数,表示错误码数组,和每个输人的测点标识对应,包括:U_ERR_OK，U_ERR_OPT POINT_NONE，U_ERR_OPT_ARCHIVE_NONE，U_ERR_oPT_HIsT_NONE，U ERR_oTHERs 返回:错误码,可为:U_ERR_OK,U_ERR_CONN_HANDLE,U_ERR_OTHERS. 0.7读取单个测点一段时间内等间隔线性拟合后的历史数据接口 pnvdues(RTB_HANLEhHamll.，RB_NT32p RTDB_HRECORDSETRTDB_Querylnterpo constHPTmeStamp关IStar'Time，constHPTimeStamp*lIEndTimme,RTDBINT32I!Step 说明;读取单个测点一段时间内等间隔线性拟合后的历史数据,并返回结果集句柄此接口与 RTDBGretNextValues、RTDBReleaseHRecordset配合使用参数.hHandle为输人参数,表示连接句柄;p为输人参数,表示测点标识;IStartTinme为输人参数,表示查寻起始时间戳;lIEndTime为输人参数,表示查询结束时间戳;IStep为输人参数，表示返回的每个历史数据的时间间隔,单位为毫秒(n ms 返回:如果正常,返回大于0的结果集句柄;否则,返回错误码,可为 U_ERR_CONN_HANDLE,U_ERR_OPT_POINT_NONE,U_ERR_OPT_ARCHIVE NONE. U_ERR_OPT_HIST_NONE,U_ERR_HIRECORISET_MALL.Oc_MEM,U_ERR_OTH ERS. 10.8读取单个测点一段时间内等间隔阶梯拟合后的历史数据接口 RTDB_HRECORDSETRTDB_QueryladderValues(RTDB_HANDLEhHandle，RTDB_INT32pt，，RTDBIT32IStep) HP_TimeStamp*IStar'Time，constHP_TimeStamp*lIEndTime, const 说明;读取单个测点一段时间内等间隔阶梯拟合后的历史数据,并返回结果集句柄此接口与 RTDB_GetNextValues,RTIDBReeaseHRecordset配合使用参数;hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;IStartTme为输人参数,表示查寻起始时间戳;lIEndTime为输人参数,表示查询结束时间截;IStep为输人参数. 表示返回的每个历史数据的时同间隔,单位为毫秒(ms) 返同;如果正常,返回大于o的结果集句柄;否则,返回错误码.可为 U_ERR_CONNLHANDLE,U_ERR_OPT_POINT_NONE,U_ERR_OPT_ARCHIVENONE， U_ERR_OPT_HISTNONE.,U_ERRHRECORDSETMALL0_MEM.,U_ERR_OTHERS 12
GB/34949一2017 数据统计 1.1查询单个测点在某个时间段内的统计数据接口 RTDB_RETcODERTDB_GetSummary(RTDB_HANDLEhHandle，RTDB_INT32pt，const 点 lEndTime，STATISTICSTYPE HP-TimeSstamp*IStartTime，constHP-Times btamp Command，TAG;VAL*pTagVal 说明:查询单个测点在某个时间段内的统计数据参数:hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;IStartTime为输人参数,表示查寻起始时间戳;lIEndTime为输人参数,表示查询结束时间戳;nCommand 为输人参数,表示统计类型;pTagVal为输出参数,表示统计值,如果是MIN,MAX类型,则设置其成员Times samp为MIN,MAX值产生的时间,否则不设置Timestamp 返回;如果正常,返回大于0的结果集句柄;否则,返回错误码,可为 U_ERR_CONN_HANDLE,U_ERR_OPT_P(OINT_NONE,U_ERR_(OPT_ARCHIVE NONE,UERROPTHIST_NONE,UERROTHERS 11.2根据过滤条件查询单个测点在某个时间内的统计数接口 RTDB_RETcoDERTDB_GetsummaryFilter(RTDB_HANDLEhHandle，RTDB_NT32p. constHP_TimeStamp关IStartTinme，constHP_TinmeStamp弟lEndTinme，consRTDB_cHAR8 exp,STATISTICs_TYPEnCommand，TAGVAL关pTagVal 说明;根据过滤条件查询单个测点在某个时间内的统计数据参数;hHandle为输人参数,表示连接句柄;pt为输人参数,表示测点标识;IStart'Timme为输人参数,表示查寻起始时间戳;lEndTinme为输人参数,表示查询结束时间戳;exp为输人参数,表示过滤字符串,支持逻辑表达式;nCommand为输人参数,表示统计类型;pTagVal 为输出参数,表示统计值,如果是MIN,MAX类型,则设置其成员Timestamp为MIN， MAX值产生的时间,否则不设置Timestamp 返回:如果正常,返回大于0的结果集句柄;否则,返回错误码,可为 U_ERR_cONN_HANDLE,U_ERR_OPT_POINT_NONE,U_ERR_OPT_ARCHIVE NONE,U_ERR_OPT_HIST_NONE,U_ERR_OTHERS 13
GB/T34949一2017 附录 A 规范性附录) 数据类型基本数据类型 A.1 基本数据类型见表A.1 表A.1基本数据类型表类型(见GB/T15272一1994 类型名说明占用存储大小中的6,1.2,5) RTDBRETcODE 4字节返回值类型 ong RTDBCHAR8 1字节 char 字符类型 RTDB_BYTE8 无符号字符类型 1字节 unsignedchar RTDB_INT16 短整型 2字节 short RTDB_UINT16 2字节无符号短整型 unsignedshort RTDB_INT32 4字节整型 long RTDB_UINT32 无符号整型 4字节 unsignedlong RTDB_INT64 长整型 8字节 longlong RTDB_UINT64 8字节无符号长整型 nedone" unsigne long RTDBFLOAT32 4字节 foat 单精度浮点型 RTDBDOUBLE64 8字节 double 双精度浮点型布尔型,0为假(FALsE). RTDBB(O(OL32 4字节 long 非0为真(TRUE) RTDBVOID 空类型 4字节 void RTDBHANDLE 句柄类型 4字节 long RTDBHRC(ORDSET 结果集句柄类型 4字节 long A.2常量定义常量定义见表A.2 14
GB/34949一2017 表A.2常量定义表常量名称说明 RTDB_MAX_TAGNAME_IEN 64 测点名称 RTDBMAX_UNIT_LEN 16 工程单位 RTDB_MAX_DES(C_LEN 128 测点描述 RTDB_MAX_SOUR_LEN 64 数据源 RTDB_MAX_S(OURCE_TAG_LEN 128 源点名 RTDB_MAX_DESCEX_LEN 256 描述扩展 RTDB_MAx_DGITAL.SET_LEN 256 状态集 RTDB_MAX_USER_LEN 64 用户名长度 RTDB_MAX_PAswoRD_LEN 64 密码长度 RTDBMAxGRoUPLEN 64 组名长度 RTDBMAxEXTENDLEN 扩展字符串长度字符型实时数据长度 RTDB_STRINGVALUE_LEN 128 A.3枚举类型 A.3.1DATA_TYPE DATA_TYPE枚举值见表A.3 表A.3DATA_TYPE枚举值表枚举名称枚举值说明 RTDB_E_DATA_TYPE_LONG 整型 RTDBEDATA_TYPE_FL(O)AT 浮点型 RTDB_E_DATA_TYPE_B0OL 布尔型 RTDBEDATATYPE_STRING 字符串 RTDBEDATA_TYPE_(OUBLE 双精度浮点型 A.3.2SORT_MODE sORT_MoDE枚举值见表A.！表A.4SORTMODE枚举值表枚举名称枚举值说明 RTDB_E_soRT_MoDE_NoT 不排序 RTDBESORT_MODEID_ASC 按照测点ID升序 RTDBESO)RT_MODPID_DESC 按照测点ID降序 RTDBESORT_MODENAME_AC 按照测点名称升序 RTDBESORT_MODE_NAME_DESC 按照测点名称降序 15
GB/T34949一2017 A.3.3STATISTcS_ITYPE STATISTICS_TYPE枚举值见表A.5 表A.5STATISTIcs_TYPE枚举值表枚举名称枚举值说明 RTDB_E_STATISTIcs_TYPE_ToTAL 总加值 RTDB_E_STATISTIcs_TYPE_MIN 最小值最大值 RTDBE_STATISTIcs_TYPE_MAx RTDBE_STATISTICS_TYPE_AVG 平均值 RTDBESTATISTICS_TYPE_COUNT 总个数 A.4结构体 A.4.1HP_TimeStamp 时间戳结构体规定量测数据的时间类型其中ISecond表示自1970年1月1日0时0分0秒开始的UTC时间的秒数,IMilSecond表示当前时间超出之前最近一个整数秒时间的毫秒数,其取值在0~ 999之间 HPTimeStamp结构体的详细描述见表A.6. 表A.6HP_TimeStamp结构体序号数据类型项名称说明秒(s Second RTDB_INT32 IMilISecond RTDB_INT32 毫秒(ms) A.4.2PointFieldl 测点属性结构体规定实时数据库测点属性注明“可选项”表示实时数据库并不一定需要支持该测点属性,没有注明“可选项”表示实时数据库应支持该测点属性 PointFied结构体的详细描述见表A.7 表A.7PointFied结构体序号数据类型项名称说明 pt RTDB_INT32 测点唯一标识 RTDB_cHAR8[RTDBMAx_TAGNAME_LEN 测点名称 ta RTDBL_CHARs[RTDB_MAx_UNIT_LEN] 工程单位,可选项 unit RTDB.CHAR8CRTDB_MAX_DESC_LEN desc 描述,可选项 DATA_TYPE 数值类型,详见枚举值部分 type RTDB_CHAR8[RTDB_MAX_SOUR_LEN] 数据源 surce RTDB_CHAR8[RTDB_MAX_SOURCE_TAG_LEN]sourcetag 源点名 16
GB/34949一2017 表A.7(续》序号数据类型项名称说明 RTDRCHAR8RLCRDMAXDEsCEX_LEN 描述扩展,可选项 descex 数值精度位数(0表示默认,非0表 RTDB_CHAR8 digits 示设定位数，二进制精度 RTDB_INT32 存档记录号,可选项 l0 record 是否采集(0表示非采集,1表示采 1 RTDB_CHAR8 scan 集是否存档(0表示不存档,1表示存 aarchive 12 RTDB_CHAR8 档 13 RTDB_CHAR8 状态字,对开关量起作用 status 14 RTDB_FL(OAT32 limit 量程下限 15 RTDB_FL(OAT32 himit 量程上限是否阶跃(0表示非阶跃,l表示阶 RTDBcHAR8 16 sten 跃 RTDB_FL(0AT32 typicalvalue 典型值(默认值是否压缩(0表示不压缩,1表示采 l8 RTDB_CHAR8 用压缩偏差参数,2表示采用变化 compress 率百分比参数 19 RTDBFL(OAT32 压缩偏差 compdey RTDB_FIOAT32 变化率百分比 20 compdevpercent 21 RTDB_INT32 最大压缩间隔 comptimemax 22 RTDB_INT32 comptimenmin 最短压缩间隔 23 RTDB_FL(0AT32 excdev 例外偏差,可选项 24 RTDB_FLOAT32 excdevpercent 例外偏差百分比,可选项 25 RTDB_IT32 最大例外间附,可选项 exctimemax 26 RTDB_INT32 最短例外间隔,可选项 exctimemin 21 RTDB_CHAR8[RTDB_MAX_EXTEND_LEN] 扩展1,可选项 expropertyl 28RTDB_CHAR8[RTDB_MAX_EXTEND_LEN] exproperty2 扩展2,可选项 29RTDB_CHAR8[RTDB_MAX_EXTEND_LEN] exproperty3 扩展3,可选项 30RTDB_CHAR8[RTDB_MAX_EXTEND_LEN] exproperty4 扩展4,可选项 RTDB_cHAR8[RTDB_MAx_ExTENDLEN 37 扩展5,可选项 exproperty5 32 RTDB_cHARs[RTDB_MAx_ExTEND_LEN expropertv6 扩展6,可选项 33 RTDB_CHARs[RTDB_MAx_ExTEND_LEN exproperty7 扩展7,可选项 3 RTDB_CHAR8[RTDB_MAX_EXTEND_LEN] 扩展8,可选项 exproperty8 扩展9,可选项 35RTDB_CHAR8[RTDB_MAX_EXTEND_LEN] exproperty9 36RTDB_CHAR8[RTB_MAX_EXTEND_LEN] eexpropertyl0 扩展10,可选项 17
GB/T34949一2017 A.4.3TAGVAL 测点值结构体规定测点值结构,包括测点标识、时间戳、质量码、点值类型和点值 TAGVAL结构体的详细描述见表A.8 表A.8TAGVAL结构体序号数据类型说明项名称 RTDB_INT32 Dt 测点标识 HPTimeStamp Timestamp 时间戳 RTDB_INT32 TagState 质量码 DATA_TYPE TagType 点值类型 rval RTDB_FLOAT32 浮点 RTDB_INT32 lval 长整 union RTDLo0L.32 开关 bval RmBCHARLRHSTRINwUE LEN 字符串 sval RTDBDOUBLE64 双精度浮点型 dval 18
GB/34949一2017 附录 B 规范性附录) 错误码 B.1基本错误码基本错误码见表B.1 表B.1基本错误码错误码说明错误码取值成功 U_ERR_OK U_ERR_cONN_HANDLE 错误的连接句柄 U_ERR_OTHERS -99 其他系统错误 B.2结果集错误码结果集错误码见表B.2 表B.2结果集错误码错误码错误码取值说明 U_ERR_RECORDSET_GET_ALL 数据已经取完 U_ERR_RECORDSET_NOT_GET_ALI 数据尚未取完 U_ERR_REcoRDsET_UNDEFINED 结果集句柄未定义 U_ERR_REcoRDSE:T_MATCH_ERR -3 结果集句柄不匹配 U_ERR_REcORDsET_MMALLoc_MEM 1l 分配内存失败 B.3连接维护错误码连接维护错误码见表B.3 表B.3连接维护错误码说明错误码错误码取值 U_ERR_CONN_NETwORK 1001 错误的网络 -1002 服务不存在 U_ERR_CONN_SERVER_NONE U_ERR_cONN_ERROR 1003 连接数据库错误 U_ERR_CONN_BL.0CKED 1004 存在防火墙 19
GB/T34949一2017 表B.3(续错误码错误码取值说明 U_ERR_C(ONN_LIMI！ -2001 已达系统最大连接数 U_ERRCONN_DISCONNECTED -2002 连接已断开 U_ERR_CONN_EXIST -2003 连接已存在用户名不存在或者密码错误 -3001 _SECURITYFAURE U_ERR_ U_ERR_AcToN_LIMIm 权限不足 -3002 B4输入参数错误码输人参数错误码见表B4 表B.4输入参数错误码错误码错误码取值说明 U_ERR_PARAM_TIME -4001 错误的时间 U_ERR_PARAM_TIME_lEN -4002 错误的时间范围 U_ERR_PARAM_INTERVAlVALUE -4003 错误的值范围 U_ERR_PARAM_POINT_DATATYPE 一4004 误的测点数据类型 U_ERR_PARAM_IP -4005 错误的IP地址 U_ERR_PARAM_COUNT -4006 错误的数目 U_ERRPARAM_NULL_POINTER -4007 空指针 U_ERR_PARAMSTRING -4008 非法字符串 -4009 U_ERR_PARAM_FILTER 错误的过滤字符串 -4101 U_ERR_PARAM_DATA 错误的数据 B.5操作错误码操作错误码见表B.5 表B.5操作错误码错误码错误码取值说明 U_ERR_OPT_POINT_NAME_EXIST -5001 测点已存在 U_ERR_OPT_POINT_NONE -5002 测点不存在 U_ERR_(OPT_POINT_PR(OPERTY -5003 测点属性错误 20
GB/34949一2017 表B.5(续错误码错误码取值说明 U_ERR_oPr_HIST_NoNE 测点无历史数据一5004 U_ERR_oPT_VALUE_NONE 测点无数据 5005 -5006 U_ERR_OPT_ARCHIVE_NoNE 测点不归档

实时数据库C语言接口规范GB/T34949-2017

一、简介

实时数据库是一种用于存储和管理实时数据的软件系统。C语言是一种广泛使用的编程语言，因其高效、灵活等特点，在实时数据库的开发中也得到了广泛应用。GB/T34949-2017是我国制定的实时数据库C语言接口规范，旨在规范实时数据库的C语言接口。

二、定义

实时数据库C语言接口规范GB/T34949-2017定义了实时数据库C语言接口，包括类型定义、函数声明和常量定义等。其中，类型定义包括基本类型、指针类型和用户自定义类型。

1. 基本类型

实时数据库C语言接口规范GB/T34949-2017定义的基本类型有：布尔型（BOOL）、字符型（CHAR）、短整型（SHORT）、整型（INT）、长整型（LONG）和双精度浮点型（DOUBLE）。这些类型可以用于声明变量、函数参数等。

2. 指针类型

实时数据库C语言接口规范GB/T34949-2017定义的指针类型有：指向布尔型的指针（PBOOL）、指向字符型的指针（PCHAR）、指向短整型的指针（PSHORT）、指向整型的指针（PINT）、指向长整型的指针（PLONG）和指向双精度浮点型的指针（PDOUBLE）。这些类型可以用于声明指针变量、函数参数等。

3. 用户自定义类型

实时数据库C语言接口规范GB/T34949-2017允许用户定义自己的数据类型。用户自定义类型可以是结构体、枚举等。

三、数据类型

实时数据库C语言接口规范GB/T34949-2017定义的数据类型包括：实时数据库句柄、记录集句柄、字段属性、字段值等。

1. 实时数据库句柄

实时数据库句柄用于表示一个实时数据库的连接，通常用于打开或关闭实时数据库。它的类型定义如下：

typedef void* HRDB;

2. 记录集句柄

记录集句柄表示数据库中的一个记录集，通常用于执行查询或更新操作。它的类型定义如下：

typedef void* HRECSET;

3. 字段属性

字段属性表示数据库中的一个字段，包括名称、数据类型、长度等信息。它的类型定义如下：

typedef struct tagDBFieldAttr
{
    char szFieldName[256]; // 字段名
    int nType; // 数据类型
    int nLen; // 长度
} DBFIELDATTR, *PDBFIELDATTR;

4. 字段值

字段值用于表示某个字段的值，它的类型与字段属性的数据类型相同。

四、函数接口

实时数据库C语言接口规范GB/T34949-2017定义了多个函数接口，包括连接数据库、打开记录集、关闭记录集、读取记录、写入记录等操作。下面是一些常用的函数接口：

1. 连接数据库

连接实时数据库，返回实时数据库句柄。

HRDB ConnectRealDB(char* pszHost, int nPort, char* pszDBName);

2. 打开记录集

打开指定的记录集，返回记录集句柄。

HRECSET OpenRecordset(HRDB hDB, char* szSQL);

3. 关闭记录集

关闭指定的记录集。

void CloseRecordset(HRECSET hRecSet);

4. 读取记录

从指定的记录集中读取一条记录，返回字段值数组。

BOOL ReadRecord(HRECSET hRecSet, int nFieldCount, PDBFIELDATTR pFieldAttrs, void** ppValues);

5. 写入记录

向指定的记录集中写入一条记录，参数为字段值数组。

BOOL WriteRecord(HRECSET hRecSet, int nFieldCount, PDBFIELDATTR pFieldAttrs, void** ppValues);

五、总结

实时数据库C语言接口规范GB/T34949-2017定义了实时数据库的C语言接口，包括类型定义、函数声明和常量定义等。使用这些接口，可以方便地操作实时数据库，进行数据的读取、写入和更新等操作。