net.rim.device.api.system
Interface MultiServicePlatformListener

All Known Implementing Classes:
ServiceBook

public interface MultiServicePlatformListener

A listener interface for multi-service platform events. These listeners implement the functionality of the BlackBerry Balance feature. BlackBerry Balance is available in BlackBerry Enterprise Server 5.0.3 and later.

You should implement a public default constructor, which makes it possible for the MultiServicePlatformManager to recreate a listener, if needed, when a wipe is initiated. The MultiServicePlatformManager may need to recreate a listener when the listener was previously registered with the MultiServicePlatformManager but is not currently registered.

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 7.0.0

Method Summary
Category: Signed  int wipe(String serviceUid, long dataType)
          Removes data associated with a specific service UID.
 



Method Detail

wipe

int wipe(String serviceUid,
         long dataType)
Removes data associated with a specific service UID. The platform calls this method when a device wipe with a specific service UID is issued. This method is executed in the registering application's address space. (The registering application is the application that called and registered the listener.)

If this method fails to wipe data when called, you can call it twice more before it gives up and returns FAILURE.

Parameters:
serviceUid - The service UID of the data that should be wiped.
dataType - The type of data that should be wiped for the specific service UID.
Returns:
MultiServicePlatformConstants.SUCCESS if successful; otherwise, MultiServicePlatformConstants.FAILURE. This method can be called a maximum of three times; after that it returns FAILURE.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 7.0.0





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal