通讯协议052——全网独有的OPC HDA知识一之接口（七）IOPCHDA_SyncAnnotations

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

1）HRESULT  QueryCapabilities(pCapabilities)

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

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

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

此函数在指定的时间域中从历史数据库中读取指定项目ID的注释。这是所有支持OPCHDA SyncAnnotations接口的服务器所需的方法。

此函数用于在指定的时间戳读取项目的注释。

请求的时域由htStartTime和htEndTime定义。如果htEndTime小于htStartTime，则应以相反的顺序返回数据，后面的数据优先。

仅当时域上不存在注释时，才返回OPC_S_NODATA。

3）HRESULT  Insert(dwNumItems, phServer, ftTimeStamps, ppAnnotationValues, ppErrors)

此函数将注释插入到历史数据库中，以记录指定时间戳的值的观察结果。这是接口上的一个可选方法。

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