This method is called by the generic server only when LookupMode is defined as 'PluginHandled'. If the request is invalid the method returns null. Otherwise, it creates a unique name for the property item creates the property item by calling the generic server method AddItem(). The plug-in must update the cache value of this item by calling the SetItemValue() method whenever the property value changes.
Syntax
| Visual Basic (Declaration) | |
|---|---|
Public Function LookupItemID( _ ByVal instanceHandle As Integer, _ ByVal itemName As String, _ ByVal propertyID As Integer _ ) As String | |
| C# | |
|---|---|
public string LookupItemID( int instanceHandle, string itemName, int propertyID ) | |
Parameters
- instanceHandle
- Handle the identifies the calling client application. The method GetServerInstancesInfo can be used to get name information for this handle.
- itemName
- Fully qualified item ID.
- propertyID
- Identification number of the property to be assigned an item.
Return Value
Fully qualified item ID of the created property item. NULL if the request is denied or failed.Requirements
Target Platforms: Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows 7, Windows Server 2008 family