【正文】 Time(long viewID, char* tagName, char* sTime) GetDataTagCommitTime函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的提交時(shí)間。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。參 數(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）GetDataTagReal long GetDataTagReal(long viewID, char* tagName, doubleamp。tagName （讀) 視圖中的一個(gè)TAG點(diǎn)參數(shù)的名稱，字符串指針。length （讀) TAG點(diǎn)參數(shù)字符型數(shù)據(jù)值長(zhǎng)度。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。GetDataTagUpdateTime函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的更新時(shí)間。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識(shí)。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。datTime （讀）要取的統(tǒng)計(jì)數(shù)據(jù)值的時(shí)間，時(shí)間有三種方法表示： 絕對(duì)時(shí)間，時(shí)間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時(shí)：分：秒”，表示取這一確定時(shí)刻所在日的實(shí)時(shí)數(shù)據(jù)平均值； 相對(duì)時(shí)間，時(shí)間格式為“DDHH:MM:SS”，意義為“天時(shí)：分：秒”表示取時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時(shí)間向前減去所表示相對(duì)時(shí)間的那一時(shí)刻所在日的實(shí)時(shí)數(shù)據(jù)平均值。因?yàn)閮H有PV值保存統(tǒng)計(jì)數(shù)據(jù)，這里也可寫成： 點(diǎn)名.PV。tagName （讀）視圖中的一個(gè)TAG點(diǎn)名稱，字符串指針。參 數(shù)viewID （讀）日統(tǒng)計(jì)數(shù)據(jù)視圖標(biāo)識(shí)。參 數(shù)viewID （讀）歷史數(shù)據(jù)視圖標(biāo)識(shí)。 dat) GetHisTagInt函數(shù)取歷史數(shù)據(jù)視圖中的一個(gè)整型數(shù)據(jù)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetHisTagReal long GetHisTagReal(long viewID, char* tagName, char* datTime, doubleamp。dat （寫）TAG點(diǎn)實(shí)型歷史數(shù)據(jù)值。tagName （讀） 視圖中的一個(gè)TAG點(diǎn)名稱，字符串指針。因?yàn)閮H有PV值保存統(tǒng)計(jì)數(shù)據(jù)，這里也可寫成： 點(diǎn)名.PV。tagName （讀）視圖中的一個(gè)TAG點(diǎn)名稱，字符串指針。參 數(shù)viewID （讀）時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖標(biāo)識(shí)。 dat)GetHourStaTagTotal函數(shù)取時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖中一個(gè)TAG點(diǎn)的某一小時(shí)中實(shí)時(shí)數(shù)據(jù)的累計(jì)值。返回值：實(shí)時(shí)數(shù)據(jù)平臺(tái)數(shù)據(jù)庫(kù)中TAG點(diǎn)個(gè)數(shù)；返回小于0的整數(shù)值表示函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetRtdbTagNamelong GetRtdbTagName(char* tagName, long count, long start = 1) GetRtdbTagName函數(shù)讀實(shí)時(shí)數(shù)據(jù)平臺(tái)數(shù)據(jù)庫(kù)中已建的TAG點(diǎn)名稱。注：（函。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明在上述取時(shí)視圖統(tǒng)計(jì)數(shù)據(jù)的時(shí)間表示法中，如果取統(tǒng)計(jì)數(shù)據(jù)的時(shí)間選擇NULL，表示取視圖建立那一個(gè)小時(shí)0分到視圖建立那一時(shí)刻之間的實(shí)時(shí)數(shù)據(jù)累計(jì)值，與取數(shù)據(jù)的時(shí)間無關(guān)；用相對(duì)時(shí)間表示時(shí)，相對(duì)時(shí)間中分鐘和秒將被截掉，如“01:15:20”將被作為“01:0:0”處理，即取建立視圖那一時(shí)刻前一個(gè)小時(shí)0分起一小時(shí)內(nèi)的實(shí)時(shí)數(shù)據(jù)累計(jì)值。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明在上述取時(shí)視圖統(tǒng)計(jì)數(shù)據(jù)的時(shí)間表示法中，如果取統(tǒng)計(jì)數(shù)據(jù)的時(shí)間選擇NULL，表示取視圖建立那一個(gè)小時(shí)0分到視圖建立那一時(shí)刻之間的實(shí)時(shí)數(shù)據(jù)最小值和最小值出現(xiàn)的時(shí)間，與取數(shù)據(jù)的時(shí)間無關(guān)；用相對(duì)時(shí)間表示時(shí)，相對(duì)時(shí)間中分鐘和秒將被截掉，如“01:15:20”將被作為“01:0:0”處理，即取建立視圖那一時(shí)刻前一個(gè)小時(shí)0分起一小時(shí)內(nèi)的實(shí)時(shí)數(shù)據(jù)最小值和最小值出現(xiàn)的時(shí)間。GetHourStaTagMin long GetHourStaTagMin(long viewID, char* tagName, char* datTime, doubleamp。 dat, char* maxTime)GetHourStaTagMax函數(shù)取時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖中一個(gè)TAG點(diǎn)的某一小時(shí)中實(shí)時(shí)數(shù)據(jù)出現(xiàn)的最大值和最大值出現(xiàn)的時(shí)間。參 數(shù)viewID （讀）時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖標(biāo)識(shí)。GetHisTagType long GetHisTagType(long viewID, char* tagName) GetHisTagType函數(shù)取歷史數(shù)據(jù)視圖中一個(gè)TAG點(diǎn)的數(shù)據(jù)類型。（注：歷史數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時(shí)間是在視圖建立時(shí)確定的，與取數(shù)據(jù)的時(shí)間無關(guān)。） NULL，歷史數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時(shí)間的歷史數(shù)據(jù)值，即視圖中最后一個(gè)數(shù)據(jù)值。status （寫）TAG點(diǎn)歷史數(shù)據(jù)的數(shù)據(jù)狀態(tài)。GetHisTagDataStatus long GetHisTagDataStatus(long viewID, char* tagName, char* datTime, longamp。GetDayStaTagTotal long GetDayStaTagTotal(long viewID, char* tagName,確char* datTime, doubleamp。 dat, char* minTime)GetDayStaTagMin函數(shù)取日統(tǒng)計(jì)數(shù)據(jù)視圖中一個(gè)TAG點(diǎn)的某一天中實(shí)時(shí)數(shù)據(jù)出現(xiàn)的最小值和最小值出現(xiàn)的時(shí)間。參 數(shù)viewID （讀）日統(tǒng)計(jì)數(shù)據(jù)視圖標(biāo)識(shí)。tagName （讀）視圖中的一個(gè)TAG點(diǎn)名稱，字符串指針。返回值：1：數(shù)據(jù)被更新；0：數(shù)據(jù)未被更新； 小于0的整數(shù)值：函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）參 見 GetDataIDGetDataUpdateTime long GetDataUpdateTime(long viewID, long dataID, char* sTime) 。GetDataType函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的數(shù)據(jù)類型。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetDataTagStatus long GetDataTagStatus(long viewID, char* tagName)GetDataTagStatus函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的狀態(tài)。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。dat （寫）TAG點(diǎn)參數(shù)整型數(shù)據(jù)值。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。返回值：指示字符型數(shù)據(jù)長(zhǎng)度或函數(shù)執(zhí)行狀態(tài)；不小于0的整數(shù)值 字符型數(shù)據(jù)長(zhǎng)度；小于0的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）參 見 GetDataIDGetDataTagCommitFlaglong GetDataTagCommitFlag(long viewID, char* tagName) GetDataTagCommitFlag函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的提交標(biāo)志，檢測(cè)數(shù)據(jù)是否被提交。參 見 GetDataIDGetDataStr long GetDataStr(long viewID, long dataID, char* dat, long length) GetDataStr函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中的字符型數(shù)據(jù)。 dat) GetDataReal函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中的實(shí)型數(shù)據(jù)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）參 見 GetDataIDGetDataModifyFlag long GetDataModifyFlag(long viewID, long dataID) GetDataModifyFlag函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的修改標(biāo)志，檢測(cè)數(shù)據(jù)是否被修改。GetDataID函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中的數(shù)據(jù)標(biāo)識(shí)?？赡艿臓顟B(tài)值及 其意義如下： Data_Success 1 數(shù)據(jù)成功提交 Data_NotChange 2 成功提交與前一值相同的數(shù)據(jù) Data_SourceError 5 由于數(shù)據(jù)源錯(cuò)誤提交失敗 Data_UserLevelError 6 由于用戶級(jí)別錯(cuò)誤提交失敗 Data_TagStateError 7 由于點(diǎn)狀態(tài)錯(cuò)誤提交失敗 Data_ReadOnly 8 由于數(shù)據(jù)源只讀提交失敗 Data_HighLimit 9 發(fā)生超高限錯(cuò)誤提交失敗 Data_LowLimit 10 發(fā)生超低限錯(cuò)誤提交失敗 Data_OutputDisable 21 由于輸出禁止發(fā)生輸出失敗（數(shù)據(jù)寫入數(shù)據(jù) 庫(kù)但不能向外設(shè)輸出） Data_OutputHighLimit 22 由于輸出超高限發(fā)生輸出失?。〝?shù)據(jù)寫入數(shù) 據(jù)庫(kù)但不能向外設(shè)輸出） Data_OutputLowLimit 23 由于輸出超低限發(fā)生輸出失?。〝?shù)據(jù)寫入數(shù) 據(jù)庫(kù)但不能向外設(shè)輸出） Data_OutputModeError 25 由于輸出方式錯(cuò)誤發(fā)生輸出失敗（數(shù)據(jù)寫入 數(shù)據(jù)庫(kù)但不能向外設(shè)輸出） Data_OutputStateError 26 由于輸出狀態(tài)錯(cuò)誤發(fā)生輸出失?。〝?shù)據(jù)寫入 數(shù)據(jù)庫(kù)但不能向外設(shè)輸出）返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明缺省情況下，每個(gè)用戶被設(shè)成禁止回送現(xiàn)場(chǎng)設(shè)備狀態(tài)，每個(gè)視圖被設(shè)成允許回送現(xiàn)場(chǎng)設(shè)備參 見 GetDataIDGetDataCommitTime long GetDataCommitTime(long viewID, long dataID, char* sTime) GetDataCommitTime函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的提交時(shí)間。參 見 EnableUserWriteDeviceGetDataCommitFlaglong GetDataCommitFlag(long viewID, long dataID) GetDataCommitFlag函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的提交標(biāo)志，檢測(cè)數(shù)據(jù)是否被提交。參 數(shù)onOff （讀）控制開關(guān)，控制開關(guān)的開關(guān)狀態(tài)用下列符號(hào)表示：ENABLE_WRITE_DEVICE 開狀態(tài)，即允許回送現(xiàn)場(chǎng)設(shè)備數(shù)據(jù)；DISABLE_WRITE_DEVICE 關(guān)狀態(tài)，即禁止回送現(xiàn)場(chǎng)設(shè)備數(shù)據(jù)；返回值 指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明缺省情況下，每個(gè)用戶被設(shè)成禁止回送現(xiàn)場(chǎng)設(shè)備狀態(tài)，每個(gè)視圖被設(shè)成允許回送現(xiàn)場(chǎng)設(shè)備狀態(tài)但只有用戶和視圖都被設(shè)成允許回送現(xiàn)場(chǎng)設(shè)備狀態(tài)數(shù)據(jù)才能真正回送。database （讀） 數(shù)據(jù)庫(kù)名，單數(shù)據(jù)庫(kù)系統(tǒng)為NULL。database （讀） 數(shù)據(jù)庫(kù)名，單數(shù)據(jù)庫(kù)系統(tǒng)為NULL。endTime (讀) 視圖統(tǒng)計(jì)數(shù)據(jù)結(jié)束時(shí)間，視圖數(shù)據(jù)結(jié)束時(shí)間有三種方法表示： 絕對(duì)時(shí)間，時(shí)間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時(shí)：分：秒”，表示視圖數(shù)據(jù)結(jié)束時(shí)間為某一確定時(shí)間； 當(dāng)前時(shí)間，用NULL時(shí)表示； 相對(duì)時(shí)間，時(shí)間格式為“DDHH:MM:SS”，意義為“天時(shí)：分：秒”表示視圖數(shù)據(jù)結(jié)束時(shí)間為當(dāng)前時(shí)間向前減去所表示的相對(duì)時(shí)間。 viewID, char* database, long viewAttr, char* dataDesc, long tagCount, char* endTime, long count) CreateHourStaView函數(shù)建立時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖。dataDesc (讀) 視圖數(shù)據(jù)TAG點(diǎn)描述表，字符串?dāng)?shù)組指針。unit （讀） 單元號(hào)，0表示所有單元。返回值指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明日統(tǒng)計(jì)數(shù)據(jù)是作為一種歷史數(shù)據(jù)保存的，到每天的24時(shí)保存當(dāng)天的日統(tǒng)計(jì)數(shù)據(jù)。database (讀) 數(shù)據(jù)庫(kù)名，單數(shù)據(jù)庫(kù)系統(tǒng)為NULL。dataDesc (讀) 視圖數(shù)據(jù)TAG點(diǎn)參數(shù)描述表，字符串?dāng)?shù)組指針。unit （讀） 單元號(hào)，0表示所有單元。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失