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 3.6.0
Field Summary
static int
CMM_HANDLE_INVALID
The operation failed because the specified handle is invalid.
getModuleVersion(int moduleHandle,
int index)
Retrieves the version of a base module.
static int
getNumMidlets()
Returns the number of midlets installed.
static boolean
isLibrary(int moduleHandle)
Determines if a module is a library.
static boolean
isMidlet()
Determines if the current process is a midlet.
static boolean
isMidlet(int moduleHandle)
Determines if a module is a midlet.
static boolean
isResetRequired()
Determines if a reset is required to complete the installation or removal of a module.
static void
promptForResetIfRequired()
If a reset is required to complete installation or removal of a module,
a dialog will be displayed prompting the user to reset.
static int
saveNewModule(int newModuleHandle)
Saves a newly created module in the database.
static int
saveNewModule(int newModuleHandle,
boolean forceOverwrite)
Saves a newly created module in the database.
static boolean
verifySignature(int moduleHandle,
int signerId,
byte[] publicKey)
Returns true if the specified signature on the cod file verifies with the given public key.
The operation failed because the specified handle is invalid.
Since:
JDE 4.0.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.
CMM_HASH_INVALID
public static final int CMM_HASH_INVALID
The operation failed due to an invalid hash.
Since:
JDE 3.6.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.
CMM_MODULE_EXCLUDED
public static final int CMM_MODULE_EXCLUDED
The operation failed because the module is excluded by IT Policy from being present on the device
Since:
JDE 4.0.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.
CMM_MODULE_IN_USE
public static final int CMM_MODULE_IN_USE
The operation failed because the module is currently in use.
Since:
JDE 4.0.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.
CMM_MODULE_IN_USE_BY_PERSISTENT_STORE
public static final int CMM_MODULE_IN_USE_BY_PERSISTENT_STORE
The operation failed because the module is currently in use by the persistent store.
Since:
JDE 4.0.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.
CMM_MODULE_INCOMPATIBLE
public static final int CMM_MODULE_INCOMPATIBLE
The operation failed because the module is incompatible with an existing module.
Since:
JDE 3.6.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.
CMM_MODULE_INVALID
public static final int CMM_MODULE_INVALID
The operation failed because the module is invalid.
Since:
JDE 3.6.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.
CMM_MODULE_REQUIRED
public static final int CMM_MODULE_REQUIRED
The operation failed because the module is required by IT Policy to be present on the device
Since:
JDE 4.0.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.
CMM_OK
public static final int CMM_OK
The operation completed successfully.
Since:
JDE 3.6.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.
CMM_OK_MODULE_MARKED_FOR_DELETION
public static final int CMM_OK_MODULE_MARKED_FOR_DELETION
The operation completed successfully; the module has been marked for deletion at
the next reset.
Since:
JDE 4.0.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.
CMM_OK_MODULE_OVERWRITTEN
public static final int CMM_OK_MODULE_OVERWRITTEN
The operation completed successfully; a module was overwritten and marked for
deletion in the process.
Since:
JDE 3.6.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.
CMM_OUT_OF_MEMORY
public static final int CMM_OUT_OF_MEMORY
The operation failed because the handheld is out of memory.
Since:
JDE 4.1.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.
CMM_SIGNATURE_INVALID
public static final int CMM_SIGNATURE_INVALID
The operation failed due to an invalid signature.
Since:
JDE 3.6.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.
MODULE_FLAG_DELETE
public static final int MODULE_FLAG_DELETE
The module is scheduled for deletion.
Since:
JDE 3.6.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.
MODULE_FLAG_INSTALLED
public static final int MODULE_FLAG_INSTALLED
The module has been installed.
Since:
JDE 4.0.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.
MODULE_FLAG_OTA
public static final int MODULE_FLAG_OTA
The module is marked as having been loaded over-the-air.
Since:
JDE 3.6.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.
Method Detail
createNewModule
public static int createNewModule(int length)
Creates a new, empty module.
Do not use this method for sibling .cod files larger than 64KB.
Parameters:
length - Length in bytes to set aside for module.
Returns:
New module handle, or 0 if the module could not be created.
Since:
JDE 3.6.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.
createNewModule
public static int createNewModule(int totalLength,
byte[] data,
int length)
Creates a new, partially populated module.
If the number of bytes you have to provide (the length parameter) is
less than the length of the module (the totalLength parameter), then you
should write the rest of the data with subsequent invocations of
writeNewModule(int, byte[], int, int).
Parameters:
totalLength - Length in bytes of the entire module.
data - Byte array of data to write.
length - Number of bytes to write.
Returns:
New module handle, or 0 if the module could not be created.
Since:
JDE 3.6.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.
deleteModule
public static boolean deleteModule(int moduleHandle,
boolean force)
Deprecated.Use deleteModuleEx instead.
Deletes a specific module.
If the module is currently in use, it will be deleted at the next
reset.
If 'force' is false and the device contains data associated with
the specified module, the module will not be deleted. If 'force' is
true, then the module and any data associated with that module will be
deleted.
The module may be required by IT Policy application control. If this
is the case the module will not be deleted regardless of the state of
the force flag.
Parameters:
moduleHandle - Handle of module to delete.
force - If true, delete the module and any data it owns ( unless
IT Policy Application control requires the module ); if false,
delete the module only if it has no associated data.
Returns:
True if the module was deleted immediately or was scheduled for
deletion; otherwise, false.
Since:
JDE 3.6.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.
deleteModuleEx
public static int deleteModuleEx(int moduleHandle,
boolean force)
Deletes a specific module.
If the module is currently in use, it will be deleted at the next
reset.
If 'force' is false and the device contains data associated with
the specified module, the module will not be deleted. If 'force' is
true, then the module and any data associated with that module will be
deleted.
The module may be required by IT Policy application control. If this
is the case the module will not be deleted regardless of the state of
the force flag.
Parameters:
moduleHandle - Handle of module to delete.
force - If true, delete the module and any data it owns ( unless
IT Policy Application control requires the module ); if false,
delete the module only if it has no associated data.
Returns:
One of the CMM_ return codes.
Since:
JDE 4.0.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.
deleteNewModule
public static int deleteNewModule(int newModuleHandle)
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.
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.
getModuleAliasName
public static StringgetModuleAliasName(int moduleHandle,
int index)
Returns the alias name of a module.
Parameters:
moduleHandle - Handle to the module in question.
index - Ordinal to the module aliase name in question.
Returns:
Alias name of module, or null if the index is out of range.
Since:
JDE 4.1.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.
getModuleCodeSize
public static int getModuleCodeSize(int moduleHandle)
Returns the size of a module's contained code.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
Module's code size in bytes.
Since:
JDE 3.6.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.
getModuleDescription
public static StringgetModuleDescription(int moduleHandle)
Retrieves the description for a module.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
Description string, or null if the module has no description
string.
Since:
JDE 3.6.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.
getModuleDownloadTimestamp
public static long getModuleDownloadTimestamp(int moduleHandle)
Returns the download time of a module.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
The time in milliseconds on the device when the module was downloaded.
Since:
JDE 4.0.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.
getModuleFlags
public static int getModuleFlags(int moduleHandle)
Returns the flags for the specified module.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
A combination of the MODULE_FLAG_ values.
Since:
JDE 3.6.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.
getModuleHandle
public static int getModuleHandle(byte[] hash)
Returns the handle for the module with the specified SHA hash.
Parameters:
hash - SHA hash of the module.
Returns:
Module handle, or 0 if no module with the specified SHA hash exists.
Since:
JDE 4.0.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.
Returns the handle for the module with the specified name.
Parameters:
name - Name of the module.
Returns:
Module handle, or 0 if no module with the specified name exists.
Since:
JDE 3.6.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.
getModuleHandleForClass
public static int getModuleHandleForClass(Class clazz)
Returns the handle of the module which implements the given Class.
Parameters:
clazz - Class for which you want to find the implementing module.
Returns:
Handle of the module which defines the given class.
Since:
JDE 4.1.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.
getModuleHandleForObject
public static int getModuleHandleForObject(Object obj)
Returns the handle of the module which defines an object's class.
Parameters:
obj - Object for which you want to find the containing module.
Returns:
Handle of the module which defines your object's class. If your
object is an array, this method treats it as an Object.
Since:
JDE 3.6.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.
getModuleHandles
public static int[] getModuleHandles()
Returns handles for all existing modules.
Returns:
An array of integers containing the handles of all modules in the database.
Since:
JDE 3.6.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.
getModuleHandles
public static int[] getModuleHandles(boolean includeSiblings)
Returns handles for all existing modules.
Parameters:
includeSiblings - Determines whether or not sibling modules are included in the results.
Returns:
An array of integers containing the handles of all modules in the database.
Since:
JDE 4.1.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.
getModuleHash
public static byte[] getModuleHash(int moduleHandle)
Returns the SHA hash of a module.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
SHA hash of the module.
Since:
JDE 3.6.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.
getModuleHash
public static boolean getModuleHash(int moduleHandle,
byte[] moduleHash)
Retrieves the hash of a module and places it into a byte array
Parameters:
moduleHandle - Handle to the module in question.
moduleHash - The hash for the module in question. The byte array must be initialized
to store at least 20 elements.
Returns:
True if the hash for the given module handle was retrieved successfully
and placed in the byte[] parameter, false otherwise.
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.
getModuleName
public static StringgetModuleName(int moduleHandle)
Returns the name of a module.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
Name of module.
Since:
JDE 3.6.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.
getModuleName
public static StringgetModuleName(int moduleHandle,
int index)
Returns the name of a base module.
Parameters:
moduleHandle - Handle to the module in question.
index - Ordinal to the module name in question.
Returns:
Name of module, or null if the index is out of range.
Since:
JDE 3.6.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.
getModuleSignature
public static byte[] getModuleSignature(int moduleHandle,
int signerId)
Returns the signature on a module from the given signerId.
Parameters:
moduleHandle - Handle to the module in question.
signerId - The id of the signer.
Returns:
the bytes containing the signature.
Since:
JDE 4.0.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.
getModuleSignerId
public static int getModuleSignerId(int moduleHandle,
int index)
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.
getModuleTimestamp
public static long getModuleTimestamp(int moduleHandle)
Returns a module's creation time.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
Time in milliseconds since the device's origin time (midnight,
Jan 1, 1970 UTC).
Since:
JDE 3.6.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.
getModuleURL
public static StringgetModuleURL(int moduleHandle)
Returns the URL from which a module can be loaded.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
URL string, or null if the module has no URL string.
Since:
JDE 3.6.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.
getModuleVendor
public static StringgetModuleVendor(int moduleHandle)
Returns the vendor information for a module.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
Vendor information string, or null if the module has no vendor
string.
Since:
JDE 3.6.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.
getModuleVersion
public static StringgetModuleVersion(int moduleHandle)
Returns the version of a module.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
Version information string, or null if the module has no
version string.
Since:
JDE 3.6.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.
getModuleVersion
public static StringgetModuleVersion(int moduleHandle,
int index)
Retrieves the version of a base module.
Parameters:
moduleHandle - Handle to the module in question.
index - Ordinal to the module name in question.
Returns:
Version information string, or null if the module has no
version string or the index is out of range.
Since:
JDE 3.6.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.
getNumMidlets
public static int getNumMidlets()
Returns the number of midlets installed.
Since:
JDE 4.0.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.
isLibrary
public static boolean isLibrary(int moduleHandle)
Determines if a module is a library.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
True if the specified module is a library; otherwise, false.
Since:
JDE 3.6.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.
isMidlet
public static boolean isMidlet()
Determines if the current process is a midlet.
Returns:
True if the current process is a midlet; otherwise, false.
Since:
JDE 4.0.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.
isMidlet
public static boolean isMidlet(int moduleHandle)
Determines if a module is a midlet.
Parameters:
moduleHandle - Handle to the module in question.
Returns:
True if the specified module is a midlet; otherwise, false.
Since:
JDE 4.0.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.
isResetRequired
public static boolean isResetRequired()
Determines if a reset is required to complete the installation or removal of a module.
Note: the process that performs the addition/removal of the module(s)
must also be the process calling this method.
Returns:
true if a reset is required, false otherwise
Since:
JDE 4.2.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.
promptForResetIfRequired
public static void promptForResetIfRequired()
If a reset is required to complete installation or removal of a module,
a dialog will be displayed prompting the user to reset.
Note: the process that performs the addition/removal of the module(s)
must also be the process calling this method.
Since:
JDE 4.2.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.
saveNewModule
public static int saveNewModule(int newModuleHandle)
Saves a newly created module in the database.
If the module is excluded by application control IT policy this method will return
CMM_MODULE_EXCLUDED.
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.
saveNewModule
public static int saveNewModule(int newModuleHandle,
boolean forceOverwrite)
Saves a newly created module in the database.
If there is an existing module with the same name, 'forceOverwrite' is false
and the device contains data associated with the existing module which is not
compatible with the new module, the operation will fail and CMM_MODULE_INCOMPATIABLE
will be returned.
If 'forceOverwrite' is true, then the existing module will be replaced, and any data
associated with that module will be deleted.
If the module is excluded by application control IT policy this method will return
CMM_MODULE_EXCLUDED.
forceOverwrite - Force any existing module to be overwritten.
Returns:
One of the CMM_ return codes.
Since:
JDE 4.0.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.
verifySignature
public static boolean verifySignature(int moduleHandle,
int signerId,
byte[] publicKey)
Returns true if the specified signature on the cod file verifies with the given public key.
Parameters:
moduleHandle - The handle of the module to be verified.
signerId - The id of the signature on the module to be verified.
publicKey - The public key to verify the signature with.
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.
writeNewModule
public static boolean writeNewModule(int newModuleHandle,
byte[] data,
int newModuleOffset,
int length)
newModuleOffset - Byte offset into the module at which to write the data.
length - Number of bytes to write.
Returns:
True if successful; false otherwise.
Since:
JDE 3.6.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.
writeNewModule
public static boolean writeNewModule(int newModuleHandle,
int newModuleOffset,
byte[] data,
int offset,
int length)
newModuleOffset - Byte offset into the module at which to write the data.
data - Byte array of data to write.
offset - Byte offset into the data.
length - Number of bytes to write.
Returns:
True if successful; false otherwise.
Since:
JDE 4.0.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-2008 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.