通讯协议024——全网独有的OPC AE知识四之接口（八）

本文简单介绍OPC AE规范的IOPCEventAreaBrowser接口的相关知识，更多通信资源请登录网信智汇(wangxinzhihui.com)。OPC AE规范描述了OPC事件服务器应该实现的对象和接口，实现在多个OPC客户端间共享事件和警报条件。

1）HRESULT ChangeBrowsePosition(

[in] OPCAEBROWSEDIRECTION dwBrowseDirection,

[in, string] LPCWSTR szString

 );

    提供在层次空间中从当前位置向上或向下移动的方法，或移动到区域空间树中特定位置的方法。目标szString必须表示一个区域，而不是一个源。

如果传递的字符串不表示区域，则返回错误。

从“根”上移应返回E_FAIL。

2）HRESULT BrowseOPCAreas(

[in] OPCAEBROWSETYPE dwBrowseFilterType,

[in, string] LPCWSTR szFilterCriteria,

[out] LPENUMSTRING * ppIEnumString

 );

返回由传递的参数确定的区域列表的IEnumString。可以通过ChangeBrowsePosition设置完成浏览的位置。

如果没有区域或源满足筛选器约束，则返回的枚举器可能为空。枚举器返回的字符串表示当前级别中包含的区域或源。它们不包括？？和分隔符或“父”名称。

客户端可以创建并持有多个枚举器，以便一次维护多个“浏览位置”。更改一个枚举器中的浏览位置不会影响客户端创建的任何其他枚举器。客户端必须在完成每个枚举器后释放它。

3）HRESULT GetQualifiedAreaName(

[in] LPCWSTR szAreaName,

[out , string] LPWSTR *pszQualifiedAreaName

);

提供一种在层次空间中汇编完全限定的区域名称的机制。这是必需的，因为在每一点上，都只浏览当前节点下方的名称。

服务器必须为IOPCEventSubscriptionMgt:：SetFilter方法返回可以添加到pszAreaList的字符串，并且可以在IOPCEventAreaBrowser:：ChangeBrowsePosition方法中使用以移动到过程区域空间树中的特定位置。

4）HRESULT GetQualifiedSourceName(

[in] LPCWSTR szSourceName,

[out , string] LPWSTR *pszQualifiedSourceName

);

提供一种在层次空间中汇编完全限定的源名称的机制。这是必需的，因为在每一点上，都只浏览当前节点下方的名称。

       服务器必须为IOPCEventServer:：EnableConditionBySource方法返回可以添加到pszSources的字符串。

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