通訊協(xié)議024——全網(wǎng)獨有的OPC AE知識四之接口(八)

本文簡單介紹OPC AE規(guī)范的IOPCEventAreaBrowser接口的相關(guān)知識,更多通信資源請登錄網(wǎng)信智匯(wangxinzhihui.com)。OPC AE規(guī)范描述了OPC事件服務(wù)器應(yīng)該實現(xiàn)的對象和接口,實現(xiàn)在多個OPC客戶端間共享事件和警報條件。
1)? HRESULT ChangeBrowsePosition(
[in] OPCAEBROWSEDIRECTION dwBrowseDirection,
[in, string] LPCWSTR szString
?);
??? 提供在層次空間中從當(dāng)前位置向上或向下移動的方法,或移動到區(qū)域空間樹中特定位置的方法。目標szString必須表示一個區(qū)域,而不是一個源。
如果傳遞的字符串不表示區(qū)域,則返回錯誤。
從“根”上移應(yīng)返回E_FAIL。
?
2)? HRESULT BrowseOPCAreas(
[in] OPCAEBROWSETYPE dwBrowseFilterType,
[in, string] LPCWSTR szFilterCriteria,
[out] LPENUMSTRING * ppIEnumString
?);
返回由傳遞的參數(shù)確定的區(qū)域列表的IEnumString??梢酝ㄟ^ChangeBrowsePosition設(shè)置完成瀏覽的位置。
如果沒有區(qū)域或源滿足篩選器約束,則返回的枚舉器可能為空。枚舉器返回的字符串表示當(dāng)前級別中包含的區(qū)域或源。它們不包括??和分隔符或“父”名稱。
客戶端可以創(chuàng)建并持有多個枚舉器,以便一次維護多個“瀏覽位置”。更改一個枚舉器中的瀏覽位置不會影響客戶端創(chuàng)建的任何其他枚舉器??蛻舳吮仨氃谕瓿擅總€枚舉器后釋放它。
?
3)? HRESULT GetQualifiedAreaName(
[in] LPCWSTR szAreaName,
[out , string] LPWSTR *pszQualifiedAreaName
);
提供一種在層次空間中匯編完全限定的區(qū)域名稱的機制。這是必需的,因為在每一點上,都只瀏覽當(dāng)前節(jié)點下方的名稱。
服務(wù)器必須為IOPCEventSubscriptionMgt::SetFilter方法返回可以添加到pszAreaList的字符串,并且可以在IOPCEventAreaBrowser::ChangeBrowsePosition方法中使用以移動到過程區(qū)域空間樹中的特定位置。
?
4)HRESULT GetQualifiedSourceName(
[in] LPCWSTR szSourceName,
[out , string] LPWSTR *pszQualifiedSourceName
);
提供一種在層次空間中匯編完全限定的源名稱的機制。這是必需的,因為在每一點上,都只瀏覽當(dāng)前節(jié)點下方的名稱。
服務(wù)器必須為IOPCEventServer::EnableConditionBySource方法返回可以添加到pszSources的字符串。
更多通信資源請登錄網(wǎng)信智匯(wangxinzhihui.com)。