uaPLUS Reference
GetItemProperties Method
See Also  Send Feedback
NSPlugin Namespace > GenericServer Class : GetItemProperties Method

itemID
The fully qualified item ID.
returnValues
The property value must be returned additionally.
returnAll
All properties defined for this item have to be returned. The numProp and propertyIDs arguments are undefined in this case.
numProp
The number of requested properties. Ignore this argument if returnAll is true.
propertyIDs
REF: Array with the IDs of the properties to be returned. If returnAll is true then this argument should be ignored and used as an out parameter to return an array with the IDs of the returned properties.
propertyNames
OUT: Array with the name of each returned property. This is used only in the XML DA server.
propertyDescr
OUT: Array with the description of each returned property.
Values
OUT: Array with the Value of each returned property. Only if returnValues is true. Otherwise null is returned.
errors
OUT: Array with the HRESULT code of each returned property.

Glossary Item Box

Virtual mode browse handling.

Called only from the Professional edition generic server.

Returns the the values of the requested properties for one item. This method is called in virtual browse mode for items that are not yet added to the generic cache.

Syntax

Visual Basic (Declaration) 
Public Function GetItemProperties( _
   ByVal itemID As String, _
   ByVal returnValues As Boolean, _
   ByVal returnAll As Boolean, _
   ByRef numProp As Integer, _
   ByRef propertyIDs As Integer(), _
   ByRef propertyNames As String(), _
   ByRef propertyDescr As String(), _
   ByRef Values As Object(), _
   ByRef errors As Integer() _
) As Integer
C# 
public int GetItemProperties( 
   string itemID,
   bool returnValues,
   bool returnAll,
   ref int numProp,
   ref int[] propertyIDs,
   out string[] propertyNames,
   out string[] propertyDescr,
   out object[] Values,
   out int[] errors
)

Parameters

itemID
The fully qualified item ID.
returnValues
The property value must be returned additionally.
returnAll
All properties defined for this item have to be returned. The numProp and propertyIDs arguments are undefined in this case.
numProp
The number of requested properties. Ignore this argument if returnAll is true.
propertyIDs
REF: Array with the IDs of the properties to be returned. If returnAll is true then this argument should be ignored and used as an out parameter to return an array with the IDs of the returned properties.
propertyNames
OUT: Array with the name of each returned property. This is used only in the XML DA server.
propertyDescr
OUT: Array with the description of each returned property.
Values
OUT: Array with the Value of each returned property. Only if returnValues is true. Otherwise null is returned.
errors
OUT: Array with the HRESULT code of each returned property.

Return Value

HRESULT success/error code. Returns S_OK if all requested properties are successfully returned, S_FALSE if an error is returned for one or more properties. If an error is returned then the out parameters are null (Nothing) HRESULT error/success code

Requirements

Target Platforms: Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows 7, Windows Server 2008 family

See Also

© 2010-2018 Copyright Advosol Inc. All Rights Reserved.