【正文】 ，表示視圖數(shù)據(jù)結(jié)束時(shí)間為某一確定時(shí)間； 當(dāng)前時(shí)間，用NULL時(shí)表示； 相對時(shí)間，時(shí)間格式為“DDHH:MM:SS”，意義為“天時(shí)：分：秒”表示視圖數(shù)據(jù)結(jié)束時(shí)間為當(dāng)前時(shí)間向前減去所表示的相對時(shí)間。因?yàn)閮H有PV值保存歷史數(shù)據(jù)，這里也可寫成： 點(diǎn)名.PV。dataDesc (讀) 視圖數(shù)據(jù)TAG點(diǎn)描述表，字符串?dāng)?shù)組指針。database (讀) 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。 viewID, char* database, long viewAttr, char* dataDesc, long tagCount, char* endTime, char* spanTime, long count) CreateHisView函數(shù)建立歷史數(shù)據(jù)視圖。count (讀) 視圖中記錄個數(shù)。unit （讀） 單元號，0表示所有單元。database （讀） 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。 viewID, char* database, long area, long unit, long viewAttr, long count)CreateEventView函數(shù)建立事件記錄視圖。在上述視圖統(tǒng)計(jì)數(shù)據(jù)結(jié)束時(shí)間表示法中，用絕對時(shí)間表示時(shí)，小時(shí)、分鐘和秒沒有意義，函數(shù)執(zhí)行時(shí)小時(shí)、分鐘和秒將被截掉，如“1997:7:309:24:12”，作為“1997:7:300:0:0”處理；用當(dāng)前時(shí)間表示時(shí)，最后一個數(shù)據(jù)是當(dāng)前日到當(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ù)視圖中最后一個數(shù)據(jù)是從1998年3月5日到1998年3月5日8時(shí)25分36秒的統(tǒng)計(jì)數(shù)據(jù)；用相對時(shí)間表示時(shí)，相對時(shí)間中小時(shí)、分鐘和秒將被截掉，如“19:8:20”將被作為“10:0:0”處理，即日統(tǒng)計(jì)數(shù)據(jù)視圖中最后一個數(shù)據(jù)是當(dāng)日前一天的數(shù)據(jù)。返回值指示函數(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ù)。endTime (讀) 視圖統(tǒng)計(jì)數(shù)據(jù)結(jié)束時(shí)間，視圖數(shù)據(jù)結(jié)束時(shí)間有三種方法表示： 絕對時(shí)間，時(shí)間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時(shí)：分：秒”，表示視圖數(shù)據(jù)結(jié)束時(shí)間為某一確定時(shí)間； 當(dāng)前時(shí)間，用NULL時(shí)表示； 相對時(shí)間，時(shí)間格式為“DDHH:MM:SS”，意義為“天時(shí)：分：秒”表示視圖數(shù)據(jù)結(jié)束時(shí)間為當(dāng)前時(shí)間向前減去所表示的相對時(shí)間。因?yàn)閮H有PV值保存統(tǒng)計(jì)數(shù)據(jù)，這里也可寫成： 點(diǎn)名.PV。dataDesc (讀) 視圖數(shù)據(jù)TAG點(diǎn)描述表，字符串?dāng)?shù)組指針。database (讀) 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。CreateDayStaView函數(shù)建立日統(tǒng)計(jì)數(shù)據(jù)視圖。CreateDayStaView long CreateDayStaView(longamp。count (讀) 點(diǎn)參數(shù)描述表中點(diǎn)參數(shù)個數(shù)。dataDesc (讀) 視圖數(shù)據(jù)TAG點(diǎn)參數(shù)描述表，字符串?dāng)?shù)組指針。database (讀) 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。 viewID, char* database, long viewAttr, char* dataDesc, long count) CreateDataView函數(shù)建立實(shí)時(shí)數(shù)據(jù)視圖。count (讀) 視圖報(bào)警中記錄個數(shù)。unit （讀） 單元號，0表示所有單元。database （讀） 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。 viewID, char* database, long area, long unit, long viewAttr, long count)CreateAlarmView函數(shù)建立報(bào)警記錄視圖。參 數(shù)viewID （讀）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）Commit long Commit(long viewID) 。 // , , } TIME_DESC 。TIME_DESC數(shù)據(jù)結(jié)構(gòu)格式：typedef struct { long time 。參 數(shù)sTime （讀）ASCII時(shí)間字符串。sTime （寫）ASCII時(shí)間字符串。 // , , } TIME_DESC 。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）AsciiTime long AsciiTime(TIME_DESC* bTime, char* sTime)AsciiTime函數(shù)將二進(jìn)制時(shí)間轉(zhuǎn)換成ASCII時(shí)間。count （讀） TAG點(diǎn)個數(shù)。tagName （讀）TAG點(diǎn)名稱數(shù)組，字符串?dāng)?shù)組指針。返回值：指示函數(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)一個或多個TAG點(diǎn)報(bào)警。unit （讀） 單元號，0表示確認(rèn)所有單元TAG點(diǎn)報(bào)警。參 數(shù)database （讀） 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。 第二部分 用戶編程接口（API）成員函數(shù)AckAlarm long AckAlarm(char* database, long area, long unit, long attr) 。用戶程序中如果要調(diào)用API，必須在程序中用include包含這兩個頭文件。）四、Windows 9Windows NT Visual C++編程環(huán)境中調(diào)用APIVisual C++編程環(huán)境中，實(shí)時(shí)數(shù)據(jù)平臺提供了兩個頭文件、一個引入庫和一個動態(tài)連接庫。連接命令如下：$clink 用戶程序程序名clink是編程環(huán)境中提供的一個命令，它完成用戶的C++程序與連接庫的自動連接。用戶程序中如果要調(diào)用API，必須在程序中用include包含這兩個頭文件。三、OPEN VMS操作系統(tǒng)C++編程環(huán)境中調(diào)用API在Alpha計(jì)算機(jī)OPEN VMS操作系統(tǒng)C++編程環(huán)境中，實(shí)時(shí)數(shù)據(jù)平臺提供了兩個頭文件和三個目標(biāo)模塊庫。表示函數(shù)執(zhí)行狀態(tài)的返回值總是一個整型數(shù)，當(dāng)返回值大于零時(shí)表示函數(shù)執(zhí)行正確，當(dāng)返回值小于或等于零時(shí)，表示函數(shù)執(zhí)行失敗。用戶建立了CUserApi類的實(shí)例以后，就可以直接調(diào)用CUserApi類的成員函數(shù)實(shí)時(shí)數(shù)據(jù)平臺中的數(shù)據(jù)庫。實(shí)時(shí)數(shù)據(jù)平臺 C++接口函數(shù)參考手冊實(shí)時(shí)數(shù)據(jù)平臺C++接口函數(shù)參考手冊 第一部分 用戶編程接口說明一、C++語言用戶接口函數(shù)類實(shí)時(shí)數(shù)據(jù)平臺在Alpha計(jì)算機(jī)OPEN VMS操作系統(tǒng)C++編程環(huán)境和PC機(jī)Visual C++編程環(huán)境中提供了C++語言用戶接口函數(shù)（API），供用戶編程訪問實(shí)時(shí)數(shù)據(jù)平臺中的數(shù)據(jù)庫。C++語言用戶接口函數(shù)全部放在CUserApi類中，作為CUserApi類的成員函數(shù)。二、函數(shù)返回值大部分用戶接口函數(shù)的返回值用于表示函數(shù)執(zhí)行狀態(tài)。返回值的意義見各個函數(shù)中的說明。文件分別名稱為： ，其中分別包含了函數(shù)定義和符號定義。用戶程序在編譯以后要與實(shí)時(shí)數(shù)據(jù)平臺提供的兩個目標(biāo)模塊庫連接。（注：為使此命令有郊，用戶每次以用戶身份進(jìn)入Open VMS操作系統(tǒng)用戶目錄下之后，首先執(zhí)行命令‘$ RTDBLOG’或?qū)⒋嗣罴拥接脩鬖OGIN命令過程中。文件分別名稱為：，其中分別包含了函數(shù)定義和符號定義。在用戶程序工作臺(Workspace)中，在選單project下選擇Settings..，進(jìn)入設(shè)置對話框，選擇Link設(shè)置，在Object/library ?；蛘叻旁赪indows的system下。AckAlarm函數(shù)確認(rèn)TAG點(diǎn)報(bào)警。area （讀） 區(qū)域號，0表示確認(rèn)所有區(qū)域TAG點(diǎn)報(bào)警。attr （讀） 數(shù)據(jù)庫屬性，說明確認(rèn)哪種數(shù)據(jù)庫的點(diǎn)，用下列符號表示：RTDB_ATTR_STANDARD 標(biāo)準(zhǔn)數(shù)據(jù)庫（缺省值)；RTDB_ATTR_SIMULATE 仿真數(shù)據(jù)庫。參 數(shù)database （讀） 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。因?yàn)閮H有PV值有報(bào)警數(shù)據(jù)，這 里也可寫成： 點(diǎn)名.PV。attr （讀） 數(shù)據(jù)庫屬性，說明確認(rèn)哪種數(shù)據(jù)庫的點(diǎn)，用下列符號表示： RTDB_ATTR_STANDARD 標(biāo)準(zhǔn)數(shù)據(jù)庫（缺省值)； RTDB_ATTR_SIMULATE 仿真數(shù)據(jù)庫。參 數(shù)bTime （讀）二進(jìn)制時(shí)間數(shù)據(jù)結(jié)構(gòu)。 long flag 。其中：time為二進(jìn)制時(shí)間值，flag為二進(jìn)制時(shí)間標(biāo)志：1表示絕對時(shí)間，2表示相對時(shí)間，0表示錯誤。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）BinaryTime long BinaryTime(char* sTime, TIME_DESC* bTime)BinaryTime函數(shù)將ASCII時(shí)間轉(zhuǎn)換成二進(jìn)制時(shí)間。bTime （寫）二進(jìn)制時(shí)間數(shù)據(jù)結(jié)構(gòu)。 long flag 。其中：time為二進(jìn)制時(shí)間值，flag為二進(jìn)制時(shí)間標(biāo)志：1表示絕對時(shí)間，2表示相對時(shí)間，0表示錯誤。Commit函數(shù)向?qū)崟r(shí)數(shù)據(jù)平臺提交實(shí)時(shí)數(shù)據(jù)視圖中的數(shù)據(jù)。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）CreateAlarmView long CreateAlarmView(longamp。參 數(shù)viewID （寫） 報(bào)警記錄視圖標(biāo)識。area （讀） 區(qū)域號，0表示所有區(qū)域。viewAttr （讀） 視圖屬性，用下列符號表示：VIEW_ATTR_STATIC 靜態(tài)視圖（缺省值)；VIEW_ATTR_ACTIVE 動態(tài)視圖；VIEW_ATTR_STANDARD 標(biāo)準(zhǔn)視圖，數(shù)據(jù)來自系統(tǒng)數(shù)據(jù)庫（缺省值)；VIEW_ATTR_SIMULATE 仿真視圖，數(shù)據(jù)來自仿真數(shù)據(jù)庫。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失敗；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）CreateDataViewlong CreateDataView(longamp。參 數(shù)viewID （寫）實(shí)時(shí)數(shù)據(jù)視圖標(biāo)識。viewAttr (讀) 視圖屬性，用下列符號表示：VIEW_ATTR_READONLY 只讀視圖（缺省值)；VIEW_ATTR_WRITE 可寫視圖；VIEW_ATTR_STATIC 靜態(tài)視圖（缺省值)；VIEW_ATTR_ACTIVE 動態(tài)視圖；VIEW_ATTR_STANDARD 標(biāo)準(zhǔn)視圖，數(shù)據(jù)來自系統(tǒng)數(shù)據(jù)庫（缺省值)；VIEW_ATTR_SIMULATE 仿真視圖，數(shù)據(jù)來自仿真數(shù)據(jù)庫。數(shù)組中元素均為64字節(jié)的字符串，每個元素表示一個TAG點(diǎn)參數(shù)的描述，TAG點(diǎn)參數(shù)的描述為： 點(diǎn)名.參數(shù)名.細(xì)目名。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明如果TAG點(diǎn)參數(shù)描述表中某TAG點(diǎn)僅描述為點(diǎn)名，則在建視圖時(shí)，會按隱式規(guī)則將此TAG點(diǎn)的所有參數(shù)的PV項(xiàng)自動建成。 viewID, char* database, long viewAttr, char* dataDesc, long tagCount, char* endTime, long count) 。參 數(shù)viewID （寫）日統(tǒng)計(jì)數(shù)據(jù)視圖標(biāo)識。viewAttr (讀) 視圖屬性，用下列符號表示：VIEW_ATTR_STANDARD 標(biāo)準(zhǔn)視圖，數(shù)據(jù)來自系統(tǒng)數(shù)據(jù)庫（缺省值)；VIEW_ATTR_SIMULATE 仿真視圖，數(shù)據(jù)來自仿真數(shù)據(jù)庫。數(shù)組中元素均為64字節(jié)的字符串，每個元素表示一個TAG點(diǎn)名稱。tagCount (讀) 視圖中TAG點(diǎn)個數(shù)。count (讀) 視圖中每個點(diǎn)的數(shù)據(jù)個數(shù)。日統(tǒng)計(jì)數(shù)據(jù)是以天為單位計(jì)算的，以每天0時(shí)為基準(zhǔn)。CreateEventView long CreateEventView(longamp。參 數(shù)viewID （寫） 事件記錄視圖標(biāo)識。area （讀） 區(qū)域號，0表示所有區(qū)域。viewAttr （讀） 視圖屬性，用下列符號表示：VIEW_ATTR_STATIC 靜態(tài)視圖（缺省值)；VIEW_ATTR_ACTIVE 動態(tài)視圖；VIEW_ATTR_STANDARD 標(biāo)準(zhǔn)視圖，數(shù)據(jù)來自系統(tǒng)數(shù)據(jù)庫（缺省值)；VIEW_