本文簡(jiǎn)單介紹OPC HDA規(guī)范的IOPCHDA_SyncUpdate（可選）接口方法，更多通信資源請(qǐng)登錄網(wǎng)信智匯(wangxinzhihui.com)。

?

1）HRESULT ?QueryCapabilities(pCapabilities)

此函數(shù)指定服務(wù)器支持哪些更新方法。這是所有支持OPCHDA SyncUpdate接口的服務(wù)器所必需的方法。

此調(diào)用使用ENUM作為返回參數(shù)；這對(duì)于位掩碼值是不正確的，并且排除了服務(wù)器指定多個(gè)支持的方法。為了避免對(duì)此次維護(hù)更新的IDL進(jìn)行更改，對(duì)此的更正將推遲到2.0版

?

2）HRESULT ?Insert(dwNumItems, phServer, ftTimeStamps, vDataValues, pdwQualities, ppErrors)

此函數(shù)在一個(gè)或多個(gè)項(xiàng)目的指定時(shí)間戳將值和質(zhì)量插入到歷史數(shù)據(jù)庫(kù)中。如果在指定的時(shí)間戳存在值，則不應(yīng)插入新值；ppErrors應(yīng)指示錯(cuò)誤。這是接口上的一個(gè)可選方法。

此函數(shù)用于在指定的時(shí)間戳插入新值；例如插入實(shí)驗(yàn)室數(shù)據(jù)以反映數(shù)據(jù)收集的時(shí)間。

phServer、ftTimeStamps、vValues和pdwQualities是numItems大小的數(shù)組。若要在同一時(shí)間插入多個(gè)不同項(xiàng)目的值，則ftTimeStamp數(shù)組將為每個(gè)項(xiàng)目具有相同的時(shí)間。要插入單個(gè)項(xiàng)目的值、時(shí)間戳和質(zhì)量流，請(qǐng)將項(xiàng)目數(shù)組的大小設(shè)置為要插入的值的數(shù)量，并在每個(gè)元素中放置相同的ItemID。

?

3）HRESULT ?Replace(dwNumItems, phServer, ftTimeStamps, vDataValues, pdwQualities, ppErrors)

此函數(shù)用于替換歷史數(shù)據(jù)庫(kù)中一個(gè)或多個(gè)項(xiàng)目在指定時(shí)間戳處的值和質(zhì)量。如果在指定的時(shí)間戳處不存在值，則不應(yīng)插入新值；ppErrors應(yīng)指示錯(cuò)誤。這是接口上的一個(gè)可選方法。

此函數(shù)用于替換指定時(shí)間戳處的現(xiàn)有值；例如，未正確處理但插入歷史數(shù)據(jù)庫(kù)的正確實(shí)驗(yàn)室數(shù)據(jù)。

phServer、ftTimeStamps、vValues和pdwQualities是numItems大小的數(shù)組。若要在同一時(shí)間替換多個(gè)不同項(xiàng)目的值，則ftTimeStamp數(shù)組將為每個(gè)項(xiàng)目提供相同的時(shí)間。要替換單個(gè)項(xiàng)的值、時(shí)間戳和質(zhì)量流，請(qǐng)將項(xiàng)數(shù)組的大小設(shè)置為要替換的值的數(shù)量，并在每個(gè)元素中放置相同的ItemID。

?

4）HRESULT ?InsertReplace (dwNumItems, phServer, ftTimeStamps, vDataValues, pdwQualities, ppErrors)

此函數(shù)在歷史數(shù)據(jù)庫(kù)中為一個(gè)或多個(gè)項(xiàng)目插入或替換指定時(shí)間戳的值和質(zhì)量。如果項(xiàng)目在指定的時(shí)間戳上有一個(gè)值，則新的值和質(zhì)量將取代舊的值。如果在該時(shí)間戳處沒(méi)有值，則函數(shù)將插入新數(shù)據(jù)。函數(shù)在返回之前一直運(yùn)行到完成。這是接口上的一個(gè)可選方法。

此功能旨在無(wú)條件地插入/替換值和質(zhì)量；例如對(duì)壞傳感器的值的校正。

phServer、ftTimeStamps、vValues和pdwQualities是numItems大小的數(shù)組。若要在同一時(shí)間設(shè)置多個(gè)不同項(xiàng)目的值和質(zhì)量，則ftTimeStamp數(shù)組將為每個(gè)項(xiàng)目具有相同的時(shí)間。要為單個(gè)項(xiàng)設(shè)置值、時(shí)間戳和質(zhì)量流，請(qǐng)將項(xiàng)數(shù)組的大小設(shè)置為要插入/替換的值的數(shù)量，并在每個(gè)元素中放置相同的ItemID。

S_OK作為ppError當(dāng)HDA服務(wù)器無(wú)法判斷在該時(shí)間戳是否已經(jīng)有值時(shí)，允許單個(gè)值的返回代碼。如果HDA服務(wù)器可以確定新值是否替換已經(jīng)存在的值，則應(yīng)使用OPC_S_INSERTED或OPC_S_REPLACED返回該信息。

?

5）HRESULT ?DeleteRaw (htStartTime, htEndTime, dwNumItems, phServer, ppErrors)

此函數(shù)用于從歷史數(shù)據(jù)庫(kù)中刪除組中一個(gè)或多個(gè)項(xiàng)目的指定時(shí)域的值、質(zhì)量和時(shí)間戳。這是接口上的一個(gè)可選方法。

此功能用于刪除意外輸入歷史數(shù)據(jù)庫(kù)的數(shù)據(jù)；例如從具有不正確時(shí)間戳的源刪除數(shù)據(jù)。

如果在特定項(xiàng)目的時(shí)間范圍內(nèi)未找到任何數(shù)據(jù)，則返回S_FALSE的成功狀態(tài)，并且該項(xiàng)目的錯(cuò)誤代碼為OPC_S_NODATA。

?

6）HRESULT ?DeleteAtTime (dwNumItems, phServer, ftTimeStamps, ppErrors)

此函數(shù)用于刪除歷史數(shù)據(jù)庫(kù)中組中一個(gè)或多個(gè)項(xiàng)目的指定時(shí)間戳的值和質(zhì)量。這是接口上的一個(gè)可選方法。

此功能用于刪除歷史數(shù)據(jù)庫(kù)中的特定數(shù)據(jù)；例如不正確且不能正確再現(xiàn)的實(shí)驗(yàn)室數(shù)據(jù)。

未完待續(xù)。更多通信資源請(qǐng)登錄網(wǎng)信智匯(wangxinzhihui.com)。