【正文】 GetRtdbTagCount long GetRtdbTagCount() GetRtdbTagCount函數(shù)讀實(shí)時(shí)數(shù)據(jù)平臺(tái)數(shù)據(jù)庫(kù)中已建的TAG點(diǎn)個(gè)數(shù)。 dat, char* minTime)GetHourStaTagMin函數(shù)取時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖中一個(gè)TAG點(diǎn)的某一小時(shí)中實(shí)時(shí)數(shù)據(jù)出現(xiàn)的最小值和最小值出現(xiàn)的時(shí)間。tagName （讀）視圖中的一個(gè)TAG點(diǎn)名稱(chēng)，字符串指針。） NULL，歷史數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時(shí)間的歷史數(shù)據(jù)值，即視圖中最后一個(gè)數(shù)據(jù)值。返回值指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetHisTagInt long GetHisTagInt(long viewID, char* tagName, char* datTime, longamp。 dat)GetDayStaTagTotal函數(shù)取時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖中一個(gè)TAG點(diǎn)某一天實(shí)時(shí)數(shù)據(jù)的累計(jì)值。tagName （讀）視圖中的一個(gè)TAG點(diǎn)名稱(chēng)，字符串指針。GetDataUpdateTime函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的更新時(shí)間。返回值：1：數(shù)據(jù)被更新；0：數(shù)據(jù)未被更新； 小于0的整數(shù)值：函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetDataTagUpdateTime long GetDataTagUpdateTime(long viewID, char* tagName, char* sTime) 。dat （寫(xiě)）TAG點(diǎn)參數(shù)字符型數(shù)據(jù)值。sTime （寫(xiě)）數(shù)據(jù)的修改時(shí)間，時(shí)間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時(shí)：分：秒”。tagName （讀) 視圖中的一個(gè)TAG點(diǎn)參數(shù)的名稱(chēng)，字符串指針。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。tagDesc （讀）視圖中的一個(gè)TAG點(diǎn)參數(shù)描述，字符串指針。count (讀) 視圖中每個(gè)點(diǎn)的數(shù)據(jù)個(gè)數(shù)。數(shù)組中元素均為64字節(jié)的字符串，每個(gè)元素表示一個(gè)TAG點(diǎn)名稱(chēng)。日統(tǒng)計(jì)數(shù)據(jù)是以天為單位計(jì)算的，以每天0時(shí)為基準(zhǔn)。數(shù)組中元素均為64字節(jié)的字符串，每個(gè)元素表示一個(gè)TAG點(diǎn)參數(shù)的描述，TAG點(diǎn)參數(shù)的描述為： 點(diǎn)名.參數(shù)名.細(xì)目名。Commit函數(shù)向?qū)崟r(shí)數(shù)據(jù)平臺(tái)提交實(shí)時(shí)數(shù)據(jù)視圖中的數(shù)據(jù)。attr （讀） 數(shù)據(jù)庫(kù)屬性，說(shuō)明確認(rèn)哪種數(shù)據(jù)庫(kù)的點(diǎn)，用下列符號(hào)表示： RTDB_ATTR_STANDARD 標(biāo)準(zhǔn)數(shù)據(jù)庫(kù)（缺省值)； RTDB_ATTR_SIMULATE 仿真數(shù)據(jù)庫(kù)。文件分別名稱(chēng)為：，其中分別包含了函數(shù)定義和符號(hào)定義。用戶(hù)建立了CUserApi類(lèi)的實(shí)例以后，就可以直接調(diào)用CUserApi類(lèi)的成員函數(shù)實(shí)時(shí)數(shù)據(jù)平臺(tái)中的數(shù)據(jù)庫(kù)。 第二部分 用戶(hù)編程接口（API）成員函數(shù)AckAlarm long AckAlarm(char* database, long area, long unit, long attr) 。 // , , } TIME_DESC 。database （讀） 數(shù)據(jù)庫(kù)名，單數(shù)據(jù)庫(kù)系統(tǒng)為NULL。CreateDayStaView函數(shù)建立日統(tǒng)計(jì)數(shù)據(jù)視圖。database （讀） 數(shù)據(jù)庫(kù)名，單數(shù)據(jù)庫(kù)系統(tǒng)為NULL。count (讀) 視圖中每個(gè)點(diǎn)的數(shù)據(jù)個(gè)數(shù)。 viewID, char* database, char* tagName, long viewAttr, long count)CreateTagAlarmView函數(shù)建立單點(diǎn)報(bào)警記錄視圖。參 數(shù)viewID （讀）數(shù)據(jù)視圖標(biāo)識(shí)。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識(shí)。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識(shí)。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識(shí)。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。tagName （讀) 視圖中的一個(gè)TAG點(diǎn)參數(shù)的名稱(chēng)，字符串指針。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。sTime （寫(xiě)）數(shù)據(jù)的更新時(shí)間，時(shí)間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時(shí)：分：秒”。 dat)GetDayStaTagAverage函數(shù)取日統(tǒng)計(jì)數(shù)據(jù)視圖中一個(gè)TAG點(diǎn)的某一天實(shí)時(shí)數(shù)據(jù)的平均值。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說(shuō) 明在上述取日視圖統(tǒng)計(jì)數(shù)據(jù)的時(shí)間表示法中，如果取統(tǒng)計(jì)數(shù)據(jù)的時(shí)間選擇NULL，表示取視圖建立那一個(gè)天0小時(shí)到視圖建立那一時(shí)刻之間的實(shí)時(shí)數(shù)據(jù)最大值和最大值出現(xiàn)的時(shí)間，與取數(shù)據(jù)的時(shí)間無(wú)關(guān)；用相對(duì)時(shí)間表示時(shí)，相對(duì)時(shí)間中小時(shí)、分鐘和秒將被截掉，如“18:15:20”將被作為“10:0:0”處理，即取建立視圖的前一天0小時(shí)起一天內(nèi)的實(shí)時(shí)數(shù)據(jù)最大值和最大值出現(xiàn)的時(shí)間。dat （寫(xiě)）TAG點(diǎn)統(tǒng)計(jì)數(shù)據(jù)值。datTime （讀）歷史數(shù)據(jù)值的時(shí)間，歷史數(shù)據(jù)值的時(shí)間有三種方法表示： 絕對(duì)時(shí)間，時(shí)間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時(shí)：分：秒”，表示取某一確定時(shí)間的歷史數(shù)據(jù)值； 相對(duì)時(shí)間，時(shí)間格式為“DDHH:MM:SS”，意義為“天時(shí)：分：秒”表示取歷史數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時(shí)間向前減去所表示相對(duì)時(shí)間的那一時(shí)刻的歷史數(shù)據(jù)值。因?yàn)閮H有PV值保存歷史數(shù)據(jù)，這里也可寫(xiě)成： 點(diǎn)名.PV。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說(shuō) 明在上述取時(shí)視圖統(tǒng)計(jì)數(shù)據(jù)的時(shí)間表示法中，如果取統(tǒng)計(jì)數(shù)據(jù)的時(shí)間選擇NULL，表示取視圖建立那一個(gè)小時(shí)0分到視圖建立那一時(shí)刻之間的實(shí)時(shí)數(shù)據(jù)平均值，與取數(shù)據(jù)的時(shí)間無(wú)關(guān)；用相對(duì)時(shí)間表示時(shí)，相對(duì)時(shí)間中分鐘和秒將被截掉，如“01:15:20”將被作為“01:0:0”處理，即取建立視圖那一時(shí)刻前一個(gè)小時(shí)0分起一小時(shí)內(nèi)的實(shí)時(shí)數(shù)據(jù)平均值。dat （寫(xiě)）TAG點(diǎn)統(tǒng)計(jì)數(shù)據(jù)值。start （讀）從實(shí)時(shí)數(shù)據(jù)平臺(tái)數(shù)據(jù)庫(kù)中讀TAG點(diǎn)名稱(chēng)的起始序號(hào)。tagName （讀）視圖中的一個(gè)TAG點(diǎn)名稱(chēng)，字符串指針。datTime （讀）要取的統(tǒng)計(jì)數(shù)據(jù)值的時(shí)間，時(shí)間有三種方法表示： 絕對(duì)時(shí)間，時(shí)間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時(shí)：分：秒”，表示取這一確定時(shí)刻所在小時(shí)內(nèi)的實(shí)時(shí)數(shù)據(jù)出現(xiàn)的最大值和最大值出現(xiàn)的時(shí)間； 相對(duì)時(shí)間，時(shí)間格式為“DDHH:MM:SS”，意義為“天時(shí)：分：秒”表示取時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時(shí)間向前減去所表示相對(duì)時(shí)間的那一時(shí)刻所在的小時(shí)內(nèi)實(shí)時(shí)數(shù)據(jù)出現(xiàn)的最大值和最大值出現(xiàn)的時(shí)間； NULL，時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時(shí)間的那個(gè)小時(shí)0分到數(shù)據(jù)結(jié)束時(shí)間之間實(shí)時(shí)數(shù)據(jù)出現(xiàn)的最大值和最大值出現(xiàn)的時(shí)間，即視圖中最后一個(gè)數(shù)據(jù)。返回值：歷史數(shù)據(jù)視圖中TAG點(diǎn)的數(shù)據(jù)類(lèi)型，數(shù)據(jù)類(lèi)型分別為：DATA_TYPE_REAL 實(shí)型；DATA_TYPE_INTEGER 整型；DATA_TYPE_STRING 字符型。參 數(shù)viewID （讀）歷史數(shù)據(jù)視圖標(biāo)識(shí)。因?yàn)閮H有PV值保存歷史數(shù)據(jù)，這里也可寫(xiě)成： 點(diǎn)名.PV。datTime （讀）要取的統(tǒng)計(jì)數(shù)據(jù)值的時(shí)間，時(shí)間有三種方法表示： 絕對(duì)時(shí)間，時(shí)間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時(shí)：分：秒”，表示取這一確定時(shí)刻所在日內(nèi)的實(shí)時(shí)數(shù)據(jù)出現(xiàn)的最小值和最小值出現(xiàn)的時(shí)間； 相對(duì)時(shí)間，時(shí)間格式為“DDHH:MM:SS”，意義為“天時(shí)：分：秒”表示取時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時(shí)間向前減去所表示相對(duì)時(shí)間的那一時(shí)刻所在日實(shí)時(shí)數(shù)據(jù)出現(xiàn)的最小值和最小值出現(xiàn)的時(shí)間； NULL，時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時(shí)間的那一天0小時(shí)起到數(shù)據(jù)結(jié)束時(shí)間之間實(shí)時(shí)數(shù)據(jù)出現(xiàn)的最小值和最小值出現(xiàn)的時(shí)間，即視圖中最后一個(gè)數(shù)據(jù)。dat （寫(xiě)）TAG點(diǎn)日實(shí)時(shí)數(shù)據(jù)平均值。返回小于1的整數(shù)值表示函數(shù)執(zhí)行失敗。返回小于1的整數(shù)值表示函數(shù)執(zhí)行失敗。返回值：實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的狀態(tài)。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。tagName （讀) 視圖中的一個(gè)TAG點(diǎn)參數(shù)的名稱(chēng)，字符串指針。length （讀) TAG點(diǎn)參數(shù)字符型數(shù)據(jù)值長(zhǎng)度。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）參 見(jiàn) GetDataIDGetDataExist long GetDataExist(long viewID, long dataID)GetDataExist函數(shù)檢查實(shí)時(shí)數(shù)據(jù)視圖中的TAG點(diǎn)參數(shù)在數(shù)據(jù)庫(kù)中是否存在。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。count (讀) 視圖中記錄個(gè)數(shù)。dataDesc (讀) 視圖數(shù)據(jù)TAG點(diǎn)描述表，字符串?dāng)?shù)組指針。 viewID, char* database, long viewAttr, char* dataDesc, long tagCount, char* endTime, char* spanTime, long count) CreateHisView函數(shù)建立歷史數(shù)據(jù)視圖。因?yàn)閮H有PV值保存統(tǒng)計(jì)數(shù)據(jù)，這里也可寫(xiě)成： 點(diǎn)名.PV。 viewID, char* database, long viewAttr, char* dataDesc, long count) CreateDataView函數(shù)建立實(shí)時(shí)數(shù)據(jù)視圖。TIME_DESC數(shù)據(jù)結(jié)構(gòu)格式：typedef struct { long time 。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??； 注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）AckTagAlarm long AckTagAlarm (char* database, char* tagName, long count, long attr)AckTagAlarm函數(shù)確認(rèn)一個(gè)或多個(gè)TAG點(diǎn)報(bào)警。用戶(hù)程序中如果要調(diào)用API，必須在程序中用include包含這兩個(gè)頭文件。文件分別名稱(chēng)為： ，其中分別包含了函數(shù)定義和符號(hào)定義。attr （讀） 數(shù)據(jù)庫(kù)屬性，說(shuō)明確認(rèn)哪種數(shù)據(jù)庫(kù)的點(diǎn)，用下列符號(hào)表示：RTDB_ATTR_STANDARD 標(biāo)準(zhǔn)數(shù)據(jù)庫(kù)（缺省值)；RTDB_ATTR_SIMULATE 仿真數(shù)據(jù)庫(kù)。bTime （寫(xiě)）二進(jìn)制時(shí)間數(shù)據(jù)結(jié)構(gòu)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）CreateDataViewlong CreateDataView(longamp。數(shù)組中元素均為64字節(jié)的字符串，每個(gè)元素表示一個(gè)TAG點(diǎn)名稱(chēng)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）CreateHisView long CreateHisView(longamp。viewAttr (讀) 視圖屬性，用下列符號(hào)表示：VIEW_ATTR_STANDARD 標(biāo)準(zhǔn)視圖，數(shù)據(jù)來(lái)自系統(tǒng)數(shù)據(jù)庫(kù)（缺省值)；VIEW_ATTR_SIMULATE 仿真視圖，數(shù)據(jù)來(lái)自仿真數(shù)據(jù)庫(kù)。viewAttr （讀） 視圖屬性，用下列符號(hào)表示：VIEW_ATTR_STATIC 靜態(tài)視圖（缺省值)；VIEW_ATTR_ACTIVE 動(dòng)態(tài)視圖；VIEW_ATTR_STANDARD 標(biāo)準(zhǔn)視圖，數(shù)據(jù)來(lái)自系統(tǒng)數(shù)據(jù)庫(kù)（缺省值)；VIEW_ATTR_SIMULATE 仿真視圖，數(shù)據(jù)來(lái)自仿真數(shù)據(jù)庫(kù)。參 見(jiàn) EnableViewWriteDeviceEnableViewWriteDevicelong EnableViewWriteDevice(long viewID, long onOff)EnableViewWriteDevice函數(shù)設(shè)置視圖級(jí)的允許/禁止回送現(xiàn)場(chǎng)設(shè)備數(shù)據(jù)控制開(kāi)關(guān)。sTime （寫(xiě)）數(shù)據(jù)的提交時(shí)間，時(shí)間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時(shí)：分：秒”。返回值：1：數(shù)據(jù)被修改；0：數(shù)據(jù)未被修改； 小于0的整數(shù)值：函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）參 見(jiàn) GetDataIDGetDataModifyTime long GetDataModifyTime(long viewID, long dataID, char* sTime)GetDataModifyTime函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的修改時(shí)間。dat （寫(xiě)）TAG點(diǎn)參數(shù)字符型數(shù)據(jù)值。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。tagName （讀) 視圖中的一個(gè)TAG點(diǎn)參數(shù)的名稱(chēng)，字符串指針。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。返回值：實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的數(shù)據(jù)類(lèi)型，數(shù)據(jù)類(lèi)型分別為：DATA_TYPE_REAL