【正文】 據(jù)庫(kù)名，單數(shù)據(jù)庫(kù)系統(tǒng)為NULL。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ù)。dataDesc (讀) 視圖數(shù)據(jù)TAG點(diǎn)描述表，字符串?dāng)?shù)組指針。數(shù)組中元素均為64字節(jié)的字符串，每個(gè)元素表示一個(gè)TAG點(diǎn)名稱。因?yàn)閮H有PV值保存歷史數(shù)據(jù)，這里也可寫(xiě)成： 點(diǎn)名.PV。tagCount (讀) 視圖中TAG點(diǎn)個(gè)數(shù)。endTime (讀) 視圖歷史數(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í)間。spanTime (讀) 視圖歷史數(shù)據(jù)時(shí)間間隔，用相對(duì)時(shí)間表示，時(shí)間格式為“DDHH:MM:SS”，意義為“天時(shí)：分：秒”。count (讀) 視圖中每個(gè)點(diǎn)的數(shù)據(jù)個(gè)數(shù)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）CreateHourStaView long CreateHourStaView(longamp。 viewID, char* database, long viewAttr, char* dataDesc, long tagCount, char* endTime, long count) CreateHourStaView函數(shù)建立時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖。參 數(shù)viewID （寫(xiě)）時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖標(biāo)識(shí)。database (讀) 數(shù)據(jù)庫(kù)名，單數(shù)據(jù)庫(kù)系統(tǒng)為NULL。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ù)。dataDesc (讀) 視圖數(shù)據(jù)TAG點(diǎn)描述表，字符串?dāng)?shù)組指針。數(shù)組中元素均為64字節(jié)的字符串，每個(gè)元素表示一個(gè)TAG點(diǎn)名稱。因?yàn)閮H有PV值保存統(tǒng)計(jì)數(shù)據(jù)，這里也可寫(xiě)成： 點(diǎn)名.PV。tagCount (讀) 視圖中TAG點(diǎn)個(gè)數(shù)。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í)間。count (讀) 視圖中每個(gè)點(diǎn)的數(shù)據(jù)個(gè)數(shù)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說(shuō) 明時(shí)統(tǒng)計(jì)數(shù)據(jù)是作為一種歷史數(shù)據(jù)保存的，到每小時(shí)的60分鐘結(jié)束時(shí)保存這個(gè)小時(shí)的時(shí)統(tǒng)計(jì)數(shù)據(jù)。時(shí)統(tǒng)計(jì)數(shù)據(jù)是以小時(shí)為單位計(jì)算的，以每小時(shí)0分為基準(zhǔn)。在上述視圖統(tǒng)計(jì)數(shù)據(jù)結(jié)束時(shí)間表示法中，用絕對(duì)時(shí)間表示時(shí)，分鐘和秒沒(méi)有意義，函數(shù)執(zhí)行時(shí)分鐘和秒將被截掉，如“1997:7:309:24:12”，作為“1997:7:309:0:0”處理；用當(dāng)前時(shí)間表示時(shí)，最后一個(gè)數(shù)據(jù)是本小時(shí)0分到當(dāng)前時(shí)間的統(tǒng)計(jì)數(shù)據(jù)，如果統(tǒng)計(jì)數(shù)據(jù)結(jié)束時(shí)間選擇NULL，當(dāng)前時(shí)間是1998年3月5日8時(shí)25分36秒，日統(tǒng)計(jì)數(shù)據(jù)視圖中最后一個(gè)數(shù)據(jù)是從1998年3月5日8時(shí)到1998年3月5日8時(shí)25分36秒的統(tǒng)計(jì)數(shù)據(jù)；用相對(duì)時(shí)間表示時(shí)，相對(duì)時(shí)間中分鐘和秒將被截掉，如“01:15:20”將被作為“01:0:0”處理，即時(shí)統(tǒng)計(jì)數(shù)據(jù)視圖中最后一個(gè)數(shù)據(jù)是當(dāng)日前一小時(shí)的數(shù)據(jù)。CreateTagAlarmView long CreateTagAlarmView(longamp。 viewID, char* database, char* tagName, long viewAttr, long count)CreateTagAlarmView函數(shù)建立單點(diǎn)報(bào)警記錄視圖。參 數(shù)viewID （寫(xiě)） 報(bào)警記錄視圖標(biāo)識(shí)。database （讀） 數(shù)據(jù)庫(kù)名，單數(shù)據(jù)庫(kù)系統(tǒng)為NULL。tagName （讀）視圖中的一個(gè)TAG點(diǎn)名稱，字符串指針。因?yàn)閮H有PV值有報(bào)警數(shù)據(jù)，這里也可寫(xiě)成： 點(diǎn)名.PV。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ù)。count (讀) 視圖中記錄個(gè)數(shù)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）CreateTagEventView long CreateTagEventView(longamp。 viewID, char* database, char* tagDesc, long viewAttr, long count)CreateTagEventView函數(shù)建立單點(diǎn)事件記錄視圖。參 數(shù)viewID （寫(xiě)） 事件記錄視圖標(biāo)識(shí)。database （讀） 數(shù)據(jù)庫(kù)名，單數(shù)據(jù)庫(kù)系統(tǒng)為NULL。tagDesc （讀）視圖中的一個(gè)TAG點(diǎn)參數(shù)描述，字符串指針。如果僅寫(xiě)TAG點(diǎn)名稱，取這個(gè)TAG點(diǎn)所有參數(shù)發(fā)生的所有事件；如果寫(xiě)成： TAG點(diǎn)名稱.參數(shù)名稱，取指定TAG點(diǎn)指定參數(shù)發(fā)生的所有事件。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ù)。count (讀) 視圖中記錄個(gè)數(shù)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）DeleteView long DeleteView(long viewID) DeleteView函數(shù)刪除數(shù)據(jù)視圖。參 數(shù)viewID （讀）數(shù)據(jù)視圖標(biāo)識(shí)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）EnableUserWriteDevicelong EnableUserWriteDevice(long onOff)EnableUserWriteDevice函數(shù)設(shè)置用戶級(jí)的允許/禁止回送現(xiàn)場(chǎng)設(shè)備數(shù)據(jù)控制開(kāi)關(guān)。參 數(shù)onOff （讀）控制開(kāi)關(guān)，控制開(kāi)關(guān)的開(kāi)關(guān)狀態(tài)用下列符號(hào)表示：ENABLE_WRITE_DEVICE 開(kāi)狀態(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）說(shuō) 明缺省情況下，每個(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ù)才能真正回送。如果某個(gè)用戶被設(shè)成允許回送現(xiàn)場(chǎng)設(shè)備狀態(tài)，則它所建的每個(gè)視圖缺省情況下均被設(shè)成允許回送現(xiàn)場(chǎng)設(shè)備狀態(tài)，此時(shí)進(jìn)行視圖提交的話就會(huì)將數(shù)據(jù)回送到下位機(jī)（或現(xiàn)場(chǎng)設(shè)備）。這時(shí)候也可以把具體某一個(gè)視圖設(shè)成禁止回送現(xiàn)場(chǎng)設(shè)備狀態(tài)。參 見(jiàn) EnableViewWriteDeviceEnableViewWriteDevicelong EnableViewWriteDevice(long viewID, long onOff)EnableViewWriteDevice函數(shù)設(shè)置視圖級(jí)的允許/禁止回送現(xiàn)場(chǎng)設(shè)備數(shù)據(jù)控制開(kāi)關(guān)。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。onOff （讀）控制開(kāi)關(guān)，控制開(kāi)關(guān)的開(kāi)關(guān)狀態(tài)用下列符號(hào)表示：ENABLE_WRITE_DEVICE 開(kāi)狀態(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）說(shuō) 明缺省情況下，每個(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ù)才能真正回送。如果某個(gè)用戶被設(shè)成允許回送現(xiàn)場(chǎng)設(shè)備狀態(tài)，則它所建的每個(gè)視圖缺省情況下均被設(shè)成允許回送現(xiàn)場(chǎng)設(shè)備狀態(tài)，此時(shí)進(jìn)行視圖提交的話就會(huì)將數(shù)據(jù)回送到下位機(jī)（或現(xiàn)場(chǎng)設(shè)備）。這時(shí)候也可以把具體某一個(gè)視圖設(shè)成禁止回送現(xiàn)場(chǎng)設(shè)備狀態(tài)。參 見(jiàn) EnableUserWriteDeviceGetDataCommitFlaglong GetDataCommitFlag(long viewID, long dataID) GetDataCommitFlag函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的提交標(biāo)志，檢測(cè)數(shù)據(jù)是否被提交。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識(shí)。返回值：1：數(shù)據(jù)被提交；0：數(shù)據(jù)未被提交； 小于0的整數(shù)值：函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）參 見(jiàn) GetDataIDGetDataCommitStatuslong GetDataCommitStatus(long viewID, long dataID, longamp。 mitStatus) GetDataCommiStatus函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)向?qū)崟r(shí)數(shù)據(jù)庫(kù)中提交后的狀態(tài)，檢測(cè)數(shù)據(jù)是否被提交到實(shí)時(shí)數(shù)據(jù)庫(kù)中。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識(shí)。mitStatus（寫(xiě)) 實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)向?qū)崟r(shí)數(shù)據(jù)庫(kù)中提交后的狀態(tài)?？赡艿臓顟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ù)寫(xiě)入數(shù)據(jù) 庫(kù)但不能向外設(shè)輸出） Data_OutputHighLimit 22 由于輸出超高限發(fā)生輸出失?。〝?shù)據(jù)寫(xiě)入數(shù) 據(jù)庫(kù)但不能向外設(shè)輸出） Data_OutputLowLimit 23 由于輸出超低限發(fā)生輸出失敗（數(shù)據(jù)寫(xiě)入數(shù) 據(jù)庫(kù)但不能向外設(shè)輸出） Data_OutputModeError 25 由于輸出方式錯(cuò)誤發(fā)生輸出失?。〝?shù)據(jù)寫(xiě)入 數(shù)據(jù)庫(kù)但不能向外設(shè)輸出） Data_OutputStateError 26 由于輸出狀態(tài)錯(cuò)誤發(fā)生輸出失?。〝?shù)據(jù)寫(xiě)入 數(shù)據(jù)庫(kù)但不能向外設(shè)輸出）返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說(shuō) 明缺省情況下，每個(gè)用戶被設(shè)成禁止回送現(xiàn)場(chǎng)設(shè)備狀態(tài)，每個(gè)視圖被設(shè)成允許回送現(xiàn)場(chǎng)設(shè)備參 見(jiàn) GetDataIDGetDataCommitTime long GetDataCommitTime(long viewID, long dataID, char* sTime) GetDataCommitTime函數(shù)讀實(shí)時(shí)數(shù)據(jù)視圖中數(shù)據(jù)的提交時(shí)間。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識(shí)。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識(shí)。sTime （寫(xiě)）數(shù)據(jù)的提交時(shí)間，時(shí)間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時(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ù)中是否