OPC Historian .NET Server Toolkit Reference
CreateBrowser(AppPlugin,Int32[],OperatorCodes[],Object[],Int32[]) Method

The parent server object.
The filter attribute IDs.
The filter operators.
The filter values.
The validity of the filtering inputs.
Create a new browser object with the specified filters, operators and attributes. The filters will be applied to all method calls to this instance of the browser. The server is expected to validate the filter arrays. The server must support a single client having simultaneous access to multiple browse interfaces. Filtering is optional behavior for a server. If a server does not support filtering, or only supports filtering on some of the requested attributes, the server shall return an interface to a browser which is only filtered on the accepted attributes. A server which does not support filtering shall return a pointer to an unfiltered browser interface. Filter operations are additive. To successfully pass filter criteria, the item must successfully satisfy all of the filter criteria. Implementation of filtering and browsing is server specific, however it is anticipated that servers with hierarchical name spaces may only apply filters to leaves, causing them to return branches which have no leaves which satisfy the criteria. It is anticipated that a client may create one browser to locate a particular area of the hierarchy, obtain a fully qualified branch name using GetBranchPosition, then pass that branch name to another browser which is using a different filter set. Servers may optionally support wild cards for string filters. To represent a single character the “?” shall be used. To represent multiple characters the “*” shall be used.
Syntax
'Usage
 
Dim instance As AppBrowser
Dim srvBase As AppPlugin
Dim AttrID() As Integer
Dim Operator() As OperatorCodes
Dim Filter() As Object
Dim errors As Integer()
Dim value As Integer
 
value = instance.CreateBrowser(srvBase, AttrID, Operator, Filter, errors)
public int CreateBrowser( 
   AppPlugin srvBase,
   int[] AttrID,
   OperatorCodes[] Operator,
   object[] Filter,
   out int[] errors
)

Parameters

srvBase
The parent server object.
AttrID
The filter attribute IDs.
Operator
The filter operators.
Filter
The filter values.
errors
The validity of the filtering inputs.

Return Value

Success failure HRESULT
Remarks
A filter is defined by the three parameters pdwAttrID, pOperator and vFilter. The filter expression is true if the relationship of the value of the attribute to the filter value matches the filter operator. If multiple filter expressions are given, they must all be true for the item to be included.
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

AppBrowser Class
AppBrowser Members
Overload List

 

 


Copyright © 2004-2019 Advosol Inc. All rights reserved

Send Feedback