getSubservice()

getSubservice(string ssid)

This method returns a single subservice, identified by SSID.

Parameters

ssid: Format: string; Purpose: Specifies the subservice for which to retrieve information. This SSID is returned by addSubservice() or addSubservices().

Results

This method returns a single Subservice object describing the subservice requested.

There are no messages defined by this method.

Example: A returned Subservice object

This example shows a Subservice object for SSID 2344.

<Subservice xmlns="http://xml.inomial.com/smile/2.xsd">
  <SSID>2344</SSID>
  <SubscriptionUSN>9796932323</SubscriptionUSN>
  <Active>true</Active>
  <SubserviceUsername>joe@example.com</SubserviceUsername>
  <Object>
    <String name="type">emailAlias</String>
    <String name="forwardTo">joe_smith@example.com</String>
  </Object>
</Subservice>

Faults

NoSuchItemException

This fault is returned when the SSID does not correspond to an existing subservice.

Java client syntax

java -cp build/smilewsv2-client.jar [options]
 com.inomial.smile.client.v2.examples.GetSubservice ssid

ssid: Purpose: Specifies the SSID of the subservice.

Note: For more information about the Java client and the options it accepts, see Java client syntax.