通讯协议055——全网独有的OPC HDA知识一之接口（十）IOPCHDA_AsyncAnnotations

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

1）HRESULT  QueryCapabilities(pCapabilities)

此函数指定服务器支持的注释方法。它是所有支持OPCHDA AsyncAnnotations接口的服务器所必需的方法。

2）HRESULT  Read(dwTransactionID, htStartTime, htEndTime, dwNumItems, phServer, pdwCancelID, ppErrors)

此函数在指定的时间域中从历史数据库中读取指定项目ID的注释。此函数用于读取用户输入的注释，以记录指定时间戳下某个值的观测结果。结果通过客户端的IOPCHDA_DataCallback:：OnReadAnnotations方法返回。

3）HRESULT  Insert(dwTransactionID, dwNumItems, phServer, ftTimeStamps, pAnnotationValues, pdwCancelID, ppErrors)

此函数将注释插入到历史数据库中。此函数用于由用户插入注释，以记录指定时间戳的值的观察结果。结果通过客户端的IOPCHDA_DataCallback:：OnInsertAnnotations方法返回。这是接口上的一个可选方法。

4）HRESULT  Cancel(dwCancelID)

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

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