通讯协议054——全网独有的OPC HDA知识一之接口（九）IOPCHDA_AsyncUpdate

本文简单介绍OPC HDA规范的IOPCHDA_AsyncUpdate（可选）接口方法，更多通信资源请登录网信智汇(wangxinzhihui.com)。

此调用使用ENUM作为返回参数；这对于位掩码值是不正确的，并且排除了服务器指定多个支持的方法。为了避免对此次维护更新的IDL进行更改，对此的更正将推迟到2.0版。

1）HRESULT  QueryCapabilities(pCapabilities)

此函数指定服务器支持哪些更新方法。它是所有支持OPCHDA AsyncUpdate接口的服务器所必需的方法。

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

此函数将一个或多个项目的指定时间戳的值和质量插入到历史数据库中。结果通过客户端的IOPCHDA_DataCallback:：OnUpdateComplete方法返回。这是接口上的一个可选方法。

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

此函数用于替换历史数据库中一个或多个项目在指定时间戳处的值和质量。结果通过客户端的IOPCHDA_DataCallback:：OnUpdateComplete方法返回。这是接口上的一个可选方法。

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

此函数在一个或多个项目的指定时间戳插入或替换值和质量。如果项目在指定的时间戳上有一个值，则新的值和质量将取代旧的值。如果在该时间戳处没有值，则函数将插入新数据。结果通过客户端的IOPCHDA_DataCallback:：OnUpdateComplete方法返回。这是接口上的一个可选方法。

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

此函数用于从历史数据库中删除一个或多个项目的指定时域的值、质量和时间戳。结果通过客户端的IOPCHDA_DataCallback:：OnUpdateComplete方法返回。这是接口上的一个可选方法。

6）HRESULT  DeleteAtTime (dwTransactionID, dwNumItems, phServer, ftTimeStamps, pdwCancelID, ppErrors)

此函数用于删除历史数据库中一个或多个项目的指定时间戳的值和质量。结果通过客户端的IOPCHDA_DataCallback:：OnUpdateComplete方法返回。这是接口上的一个可选方法。

7）HRESULT  Cancel(dwCancelID)

此功能取消未完成的操作。实际实现是特定于服务器的，但服务器将通过客户端的IOPCHDA_Data_Callback:：OnCancelComplete方法进行响应，除非调用返回FAILED错误代码。

未完待续。更多通信资源请登录网信智汇(wangxinzhihui.com)。