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.
Visual Basic (Usage) | ![]() |
---|---|
Dim instance As GenericServer Dim instanceHandle As Integer Dim itemName As String Dim propertyID As Integer Dim value As String value = instance.LookupItemID(instanceHandle, itemName, propertyID) |
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.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