SHOW Signed
 

net.rim.device.api.crypto.transcoder
Class TranscoderManager

java.lang.Object
  |
  +--net.rim.device.api.crypto.transcoder.TranscoderManager

public final class TranscoderManager
extends Object

Provides methods for managing the transcoders on the device.

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:
JDE 4.5.0

Method Summary
 Category: Signed static void register(Transcoder transcoder)
          Registers a Transcoder.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

register

public static void register(Transcoder transcoder)
                     throws TranscoderRegistrationException

Registers a Transcoder. Once a transcoder has been registered, any messages sent from the device will be passed into its encode(...) method for encoding. Similarly, any messages sent to the device will be passed into its decode(...) method for decoding. A transcoder must re-register on device reset.

The registration will fail if

  1. the transcoder to register is null, or
  2. another transcoder is already registered, or
  3. the calling application does not have permission to register a transcoder. The permission to register a transcoder is granted by the BES administrator.

Parameters:
transcoder - the transcoder to register
Throws:
IllegalArgumentException - if transcoder is null.
TranscoderRegistrationException - if registration cannot be completed
Since:
JDE 4.5.0
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.



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.