Virtual mode browse handling.
Called only from the Professional edition generic server when BrowseMode VIRTUAL is configured.
This method browses the items in the current branch of the virtual address space. It has to be implemented according the OPC DA V2 specification.
Visual Basic (Declaration) | |
---|---|
Public Function BrowseItemIDs( _ ByVal BrowseType As Integer, _ ByVal FilterCriteria As String, _ ByVal DataTypeFilter As Type, _ ByVal AccessRightsFilter As Integer, _ ByVal currBranch As String, _ ByRef NrItems As Integer, _ ByRef ItemIDs As String() _ ) As Integer |
C# | |
---|---|
public int BrowseItemIDs( int BrowseType, string FilterCriteria, Type DataTypeFilter, int AccessRightsFilter, string currBranch, out int NrItems, out string[] ItemIDs ) |
Parameters
- BrowseType
- branch/leaf filter OPCBROWSETYPE
OPC_BRANCH - returns only items that have children
OPC_LEAF - returns only items that don't have children
OPC_FLAT - returns everything at and below this level including all children of children - basically 'pretends' that the address space in actually FLAT
This parameter is ignored for FLAT address space. - FilterCriteria
- name pattern match expression
- DataTypeFilter
- Filter the returned list based in the available datatypes (those that would succeed if passed to AddItem). System.Void indicates no filtering.
- AccessRightsFilter
- Filter based on the AccessRights bit mask OPCAccess
(OPC_READABLE or OPC_WRITEABLE). The bits passed in the bitmask are 'ANDed' with the bits that would be returned for this Item by AddItem, ValidateItem or EnumOPCItemAttributes. If the result is non-zero then the item is returned. A 0 value in the bitmask indicates that the AccessRights bits should be ignored during the filtering process. - currBranch
- current branch for the calling client
- NrItems
- OUT: number of items returned
- ItemIDs
- OUT: Items meeting the browse criteria.
Return Value
HRESULT error/success code
E_FAIL |
The operation failed. Not enough memory An argument to the function was invalid. The filter string was not valid The operation succeeded. No items meet the filter criteria. |
Target Platforms: Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows 7, Windows Server 2008 family