Service.onObjectAdded event

The onObjectAdded event occurs after an object has been added to this Service object.

Syntax

Service.onObjectAdded(
  wpdObject
)

Parameters

wpdObject: The WPDObject that was added.

Return value

This event does not return a value.

Examples

The following code shows the handler-function syntax for the onObjectAdded event.

function HandlerFunction(wpdObject)
{

   // Code to handle a newly added object.               

}

// Set the event handler.
Service.onObjectAdded = HandlerFunction;

Note

We recommend that you clear the event handler of a Service object variable by setting it to null, before reusing that variable to represent a new object. This will keep an event handler object from persisting as a property of the old Service object.

The following example demonstrates this with the Service object variable "currentService". The variable is used to represent one Service object, and a handler-function is set for that object. The handler-function is then cleared before currentService is used to represent a new Service object.

// Set this variable to represent a Service object.
currentService = deviceObject.Services[0];

// Set the event handler for the Service object.
currentService.onObjectAdded = HandlerFunction;

// Do something with the service object.
...

// Clear the event handler when done with the service object.
currentService.onObjectAdded = null;

// Set the variable to represent a new Service object.
currentService = deviceObject.Services[1];

Requirements


Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]

Share via