API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

JAMS_IAPP_QUERYINTERFACE()

Brew Release
Brew MP 1.0.2
Description
This function is from the IQI interface. It allows callers to obtain another interface handle from this instance. The following interfaces are supported: * AEEIID_IBase * AEEIID_IQI * jams_IID_IAppJsr229 * jams_IID_IProperty Gettable: Property Name Format Value Description -----------------------------------------------
"java_app_uri" ASCII string Returns the unique URI associated with the Java application. This URI is an internally defined string, beginning with the scheme "javaapp", suitable for passing jams_IApp_GetApp.
"jad_filename" ASCII string Returns the absolute path name for the JAD file associated with the Java application. This is intended to allow the caller to copy or export the JAD file if desired. Note that the JAD file is used internally within AMS Services and should not be moved, deleted, or otherwise tampered with.
"jar_filename" ASCII string Returns the absolute path name for the JAR file associated with the Java application. This is intended to allow the caller to copy or export the JAR file if desired. Note that the JAR file is used internally within the AMS Services and should not be moved, deleted, or otherwise tampered with.
"local_file_conn_dir" ASCII string Returns the local file connection directory for the Java application. This is a directory unique to each Java application, accessible by the Java application using the JSR-75 file connection API. This directory is automatically created by JAM when the Java application is installed and deleted when the Java application is uninstalled, but is otherwise not normally accessed by any other application other than Java.
"custom_content_dir" ASCII string Returns the custom content directory for the Java application or the empty string if no custom content directory is used. The custom content directory is the directory where the JAR file is stored.
"installation_url" ASCII string Returns the URL indicating where the application was installed from or can be re-installed from. This normally points to a JAD file, but can point to a JAR file.
"protection_domain" UTF-8 string Returns the protection domain the application was authenticated under (e.g. "uidentified_thirdparty" for untrusted applications, or "operator" for applications authenticated by the operator's root certificate).
"jar_size" uint Returns the size of the application's JAR file in bytes.
"rms_size" uint Returns the amount of RMS space the application has reserved or the amount of RMS space actually used by the Java application, whichever is greater.
"rms_used" uint Returns the amount of RMS space the application is using.
"num_midlets" uint Returns the total number of applications installed.
"cannot_launch_reason" uint Returns an integer representing the reason why an application cannot be launched (see "can_launch"). The possible reason are:
AEE_SUCCESS - The app is launchable.
jams_IApp_ELAUNCH_CERT_DISABLED - The root certificate state prohibits applications authenticated by it to be launched.
jams_IApp_ELAUNCH_MCCMNC - The system's MCC or MNC is different from the smart card's MCC or MNC. This only applies to applications authenticated with an operator certificate from the smart card.
jams_IApp_ELAUNCH_MAX_VM_CONTEXTS - The virtual machine cannot run the application because there are no more free contexts to run the application in.
"last_execution_time" uint Returns the time when the Java application was last executed in number of seconds since January 6, 1980 00:00:00 GMT. Zero indicates the application has never been launched.
"installation_time" uint Returns the date the application was installed or last updated in number of seconds since January 6, 1980 00:00:00 GMT.
"is_delete_protected" bool Returns TRUE if the installed is protected from deletion.
"can_launch" bool Returns TRUE if the application can be launched at this moment in time. See "cannot_launch_reason" for reasons why the application is not launchable.
"is_trusted" bool Returns TRUE if the application's "protection_domain" represents a trusted domain.
"category" uint Returns the category the application is installed under.
Settable: Property Name Format Value Description -----------------------------------------------
"custom_content_dir" ASCII string Sets the custom content directory where the JAR file is stored. The directory may be the empty string to set the custom content directory to the default directory.
"is_delete_protected" bool Sets the flag indicating if the application is delete protected.
"category" uint Sets the category the application is installed under. Any number may be used. It is the caller's responsibility to associate a category number with a category name. For example, an application can associate category 5 with "Games".
Property values: Format Description --------------------------
ASCII string C string. UTF-8 string C string encoded in UTF-8. uint C string value represented in hex (e.g. "FF") in the range [0, 2^32). bool C string value that is "false" or "true" (case sensitive).
Params
me
[]:
Pointer to the interface object.
iid
[]:
Interface ID of the interface being requested.
ppo
[]:
Where to return the object pointer.
Interface
Prototype
  •    AEEResult jams_IApp_QueryInterface
       (
          jams_IApp*	me,
          AEEIID		iid,
          void**		ppo
       );
    
Return
  • One of the following BREW error codes: AEE_SUCCESS Successfully obtained another interface handle. AEE_EFAILED or other Unspecified error.