【正文】 實型；DATA_TYPE_INTEGER 整型；DATA_TYPE_STRING 字符型。返回值：實時數(shù)據(jù)視圖中數(shù)據(jù)的數(shù)據(jù)類型，數(shù)據(jù)類型分別為：DATA_TYPE_REAL 實型；DATA_TYPE_INTEGER 整型；DATA_TYPE_STRING 字符型。 NULL，時統(tǒng)計數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時間的那一天0時到數(shù)據(jù)結(jié)束時間的實時數(shù)據(jù)平均值，即視圖中最后一個數(shù)據(jù)。因為僅有PV值保存統(tǒng)計數(shù)據(jù)，這里也可寫成： 點名.PV。tagName （讀） 視圖中的一個TAG點名稱，字符串指針。 dat) GetHisTagReal函數(shù)取歷史數(shù)據(jù)視圖中的一個實型數(shù)據(jù)。因為僅有PV值保存歷史數(shù)據(jù)，這里也可寫成： 點名.PV。因為僅有PV值保存統(tǒng)計數(shù)據(jù)，這里也可寫成： 點名.PV。參 數(shù)viewID （讀）時統(tǒng)計數(shù)據(jù)視圖標識。返回值：實際讀出的TAG點名稱個數(shù)；返回小于0的整數(shù)值表示函數(shù)執(zhí)行失敗。minTime （寫）最小值出現(xiàn)的時間，時間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時：分：秒”。GetHourStaTagMax long GetHourStaTagMax(long viewID, char* tagName, char* datTime, doubleamp。返回值：歷史數(shù)據(jù)視圖中TAG點的數(shù)據(jù)狀態(tài)。（注：歷史數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時間是在視圖建立時確定的，與取數(shù)據(jù)的時間無關(guān)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明在上述取日視圖統(tǒng)計數(shù)據(jù)的時間表示法中，如果取統(tǒng)計數(shù)據(jù)的時間選擇NULL，表示取視圖建立那一天0小時起到視圖建立那一時刻之間的實時數(shù)據(jù)累計值，與取數(shù)據(jù)的時間無關(guān)；用相對時間表示時，相對時間中小時、分鐘和秒將被截掉，如“18:15:20”將被作為“10:0:0”處理，即取建立視圖那一時刻前一天0小時起一天內(nèi)的實時數(shù)據(jù)累計值。GetDayStaTagMinlong GetDayStaTagMin(long viewID, char* tagName, char* datTime, doubleamp。參 數(shù)viewID （讀）日統(tǒng)計數(shù)據(jù)視圖標識。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetDataType long GetDataType(long viewID, long dataID) 。返回值：指示字符型數(shù)據(jù)長度或函數(shù)執(zhí)行狀態(tài)；不小于0的整數(shù)值 字符型數(shù)據(jù)長度；小于0的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetDataTagType long GetDataTagType(long viewID, char* tagName)GetDataTagType函數(shù)讀實時數(shù)據(jù)視圖中數(shù)據(jù)的數(shù)據(jù)類型。dat （寫）TAG點參數(shù)實型數(shù)據(jù)值。格式為： 點名.參數(shù)名.細目名。tagName （讀) 視圖中的一個TAG點參數(shù)的名稱，字符串指針。返回值：實時數(shù)據(jù)視圖中數(shù)據(jù)的狀態(tài)。dat （寫）TAG點參數(shù)整型數(shù)據(jù)值。mitStatus（寫) 實時數(shù)據(jù)視圖中數(shù)據(jù)向?qū)崟r數(shù)據(jù)庫中提交后的狀態(tài)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）EnableUserWriteDevicelong EnableUserWriteDevice(long onOff)EnableUserWriteDevice函數(shù)設(shè)置用戶級的允許/禁止回送現(xiàn)場設(shè)備數(shù)據(jù)控制開關(guān)。參 數(shù)viewID （寫） 報警記錄視圖標識。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）CreateHourStaView long CreateHourStaView(longamp。area （讀） 區(qū)域號，0表示所有區(qū)域。參 數(shù)viewID （寫）日統(tǒng)計數(shù)據(jù)視圖標識。area （讀） 區(qū)域號，0表示所有區(qū)域。其中：time為二進制時間值，flag為二進制時間標志：1表示絕對時間，2表示相對時間，0表示錯誤。AckAlarm函數(shù)確認TAG點報警。二、函數(shù)返回值大部分用戶接口函數(shù)的返回值用于表示函數(shù)執(zhí)行狀態(tài)。）四、Windows 9Windows NT Visual C++編程環(huán)境中調(diào)用APIVisual C++編程環(huán)境中，實時數(shù)據(jù)平臺提供了兩個頭文件、一個引入庫和一個動態(tài)連接庫。count （讀） TAG點個數(shù)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）Commit long Commit(long viewID) 。dataDesc (讀) 視圖數(shù)據(jù)TAG點參數(shù)描述表，字符串?dāng)?shù)組指針。返回值指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明日統(tǒng)計數(shù)據(jù)是作為一種歷史數(shù)據(jù)保存的，到每天的24時保存當(dāng)天的日統(tǒng)計數(shù)據(jù)。dataDesc (讀) 視圖數(shù)據(jù)TAG點描述表，字符串?dāng)?shù)組指針。endTime (讀) 視圖統(tǒng)計數(shù)據(jù)結(jié)束時間，視圖數(shù)據(jù)結(jié)束時間有三種方法表示： 絕對時間，時間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時：分：秒”，表示視圖數(shù)據(jù)結(jié)束時間為某一確定時間； 當(dāng)前時間，用NULL時表示； 相對時間，時間格式為“DDHH:MM:SS”，意義為“天時：分：秒”表示視圖數(shù)據(jù)結(jié)束時間為當(dāng)前時間向前減去所表示的相對時間。database （讀） 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。參 見 EnableUserWriteDeviceGetDataCommitFlaglong GetDataCommitFlag(long viewID, long dataID) GetDataCommitFlag函數(shù)讀實時數(shù)據(jù)視圖中數(shù)據(jù)的提交標志，檢測數(shù)據(jù)是否被提交。GetDataID函數(shù)讀實時數(shù)據(jù)視圖中的數(shù)據(jù)標識。 dat) GetDataReal函數(shù)讀實時數(shù)據(jù)視圖中的實型數(shù)據(jù)。返回值：指示字符型數(shù)據(jù)長度或函數(shù)執(zhí)行狀態(tài)；不小于0的整數(shù)值 字符型數(shù)據(jù)長度；小于0的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）參 見 GetDataIDGetDataTagCommitFlaglong GetDataTagCommitFlag(long viewID, char* tagName) GetDataTagCommitFlag函數(shù)讀實時數(shù)據(jù)視圖中數(shù)據(jù)的提交標志，檢測數(shù)據(jù)是否被提交。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標識。格式為： 點名.參數(shù)名.細目名。格式為： 點名.參數(shù)名.細目名。格式為： 點名.參數(shù)名.細目名。返回值：1：數(shù)據(jù)被更新；0：數(shù)據(jù)未被更新； 小于0的整數(shù)值：函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）參 見 GetDataIDGetDataUpdateTime long GetDataUpdateTime(long viewID, long dataID, char* sTime) 。參 數(shù)viewID （讀）日統(tǒng)計數(shù)據(jù)視圖標識。GetDayStaTagTotal long GetDayStaTagTotal(long viewID, char* tagName,確char* datTime, doubleamp。status （寫）TAG點歷史數(shù)據(jù)的數(shù)據(jù)狀態(tài)。（注：歷史數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時間是在視圖建立時確定的，與取數(shù)據(jù)的時間無關(guān)。參 數(shù)viewID （讀）時統(tǒng)計數(shù)據(jù)視圖標識。GetHourStaTagMin long GetHourStaTagMin(long viewID, char* tagName, char* datTime, doubleamp。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明在上述取時視圖統(tǒng)計數(shù)據(jù)的時間表示法中，如果取統(tǒng)計數(shù)據(jù)的時間選擇NULL，表示取視圖建立那一個小時0分到視圖建立那一時刻之間的實時數(shù)據(jù)累計值，與取數(shù)據(jù)的時間無關(guān)；用相對時間表示時，相對時間中分鐘和秒將被截掉，如“01:15:20”將被作為“01:0:0”處理，即取建立視圖那一時刻前一個小時0分起一小時內(nèi)的實時數(shù)據(jù)累計值。返回值：實時數(shù)據(jù)平臺數(shù)據(jù)庫中TAG點個數(shù)；返回小于0的整數(shù)值表示函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetRtdbTagNamelong GetRtdbTagName(char* tagName, long count, long start = 1) GetRtdbTagName函數(shù)讀實時數(shù)據(jù)平臺數(shù)據(jù)庫中已建的TAG點名稱。參 數(shù)viewID （讀）時統(tǒng)計數(shù)據(jù)視圖標識。因為僅有PV值保存統(tǒng)計數(shù)據(jù)，這里也可寫成： 點名.PV。dat （寫）TAG點實型歷史數(shù)據(jù)值。 dat) GetHisTagInt函數(shù)取歷史數(shù)據(jù)視圖中的一個整型數(shù)據(jù)。參 數(shù)viewID （讀）日統(tǒng)計數(shù)據(jù)視圖標識。因為僅有PV值保存統(tǒng)計數(shù)據(jù)，這里也可寫成： 點名.PV。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標識。GetDataTagUpdateTime函數(shù)讀實時數(shù)據(jù)視圖中數(shù)據(jù)的更新時間。length （讀) TAG點參數(shù)字符型數(shù)據(jù)值長度。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetDataTagReal long GetDataTagReal(long viewID, char* tagName, doubleamp。格式為： 點名.參數(shù)名.細目名。tagName （讀) 視圖中的一個TAG點參數(shù)的名稱，字符串指針。dataID （讀) TAG點參數(shù)數(shù)據(jù)標識。dataDesc （讀) 視圖中存在的TAG點參數(shù)名稱。dataID （讀) TAG點參數(shù)數(shù)據(jù)標識。如果僅寫TAG點名稱，取這個TAG點所有參數(shù)發(fā)生的所有事件；如果寫成： TAG點名稱.參數(shù)名稱，取指定TAG點指定參數(shù)發(fā)生的所有事件。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明時統(tǒng)計數(shù)據(jù)是作為一種歷史數(shù)據(jù)保存的，到每小時的60分鐘結(jié)束時保存這個小時的時統(tǒng)計數(shù)據(jù)。因為僅有PV值保存歷史數(shù)據(jù)，這里也可寫成： 點名.PV。在上述視圖統(tǒng)計數(shù)據(jù)結(jié)束時間表示法中，用絕對時間表示時，小時、分鐘和秒沒有意義，函數(shù)執(zhí)行時小時、分鐘和秒將被截掉，如“1997:7:309:24:12”，作為“1997:7:300:0:0”處理；用當(dāng)前時間表示時，最后一個數(shù)據(jù)是當(dāng)前日到當(dāng)前時間的統(tǒng)計數(shù)據(jù)，如果統(tǒng)計數(shù)據(jù)結(jié)束時間選擇NULL，當(dāng)前時間是1998年3月5日8時25分36秒，日統(tǒng)計數(shù)據(jù)視圖中最后一個數(shù)據(jù)是從1998年3月5日到1998年3月5日8時25分36秒的統(tǒng)計數(shù)據(jù)；用相對時間表示時，相對時間中小時、分鐘和秒將被截掉，如“19:8:20”將被作為“10:0:0”處理，即日統(tǒng)計數(shù)據(jù)視圖中最后一個數(shù)據(jù)是當(dāng)日前一天的數(shù)據(jù)。count (讀) 點參數(shù)描述表中點參數(shù)個數(shù)。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標識。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）AsciiTime long AsciiTime(TIME_DESC* bTime, char* sTime)AsciiTime函數(shù)將二進制時間轉(zhuǎn)換成ASCII時間。用戶程序中如果要調(diào)用API，必須在程序中用include包含這兩個頭文件。C++語言用戶接口函數(shù)全部放在CUserApi類中，作為CUserApi類的成員函數(shù)。或者放在Windows的system下。 long flag 。參 數(shù)viewID （寫） 報警記錄視圖標識。 viewID, char* database, long viewAttr, char* dataDesc, long tagCount, char* endTime, long count) 。參 數(shù)viewID （寫） 事件記錄視圖標識。spanTime (讀) 視圖歷史數(shù)據(jù)時間間隔，用相對時間表示，時間格式為“DDHH:MM:SS”，意義為“天時：分：秒”。CreateTagAlarmView long CreateTagAlarmView(longamp。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整