nams.c

来自「This is a resource based on j2me embedde」· C语言 代码 · 共 219 行

/*
 * Copyright  1990-2007 Sun Microsystems, Inc. All Rights Reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
 * 
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License version
 * 2 only, as published by the Free Software Foundation.
 * 
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * General Public License version 2 for more details (a copy is
 * included at /legal/license.txt).
 * 
 * You should have received a copy of the GNU General Public License
 * version 2 along with this work; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA
 * 
 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
 * Clara, CA 95054 or visit www.sun.com if you need additional
 * information or have any questions.
 */ 

/*
 * IMPL_NOTE: this file contains stubs for the functions that
 * the MIDP system invokes to inform NAMS running on the platform
 * side about the state changes happend in the MIDP, or to get
 * some information from the platform (like a domain of the midlet
 * suite having the given suite ID).
 *
 * It will be implemented when a new version of runNams that uses
 * Javacall NAMS API instead of MIDP NAMS API is created.
 */

#include <javacall_native_ams.h>

/**
 * Inform on completion of the previously requested operation.
 *
 * @param operation code of the completed operation
 * @param appID The ID used to identify the application
 * @param pResult Pointer to a static buffer containing
 *                operation-dependent result
 */
void javacall_ams_operation_completed(javacall_opcode operation,
                                      const javacall_app_id appID,
                                      void* pResult) {
}

/**
 * Inform on change of the specific MIDlet's lifecycle status.
 *
 * Java will invoke this function whenever the lifecycle status of the running
 * MIDlet is changed, for example when the running MIDlet has been paused,
 * resumed, the MIDlet has shut down etc.
 * 
 * @param state new state of the running MIDlet. Can be either,
 *        <tt>JAVACALL_MIDLET_STATE_ACTIVE</tt>
 *        <tt>JAVACALL_MIDLET_STATE_PAUSED</tt>
 *        <tt>JAVACALL_MIDLET_STATE_DESTROYED</tt>
 *        <tt>JAVACALL_MIDLET_STATE_ERROR</tt>
 * @param appID The ID of the state-changed suite
 * @param reason The reason why the state change has happened
 */
void javacall_ams_midlet_state_changed(javacall_lifecycle_state state,
                                       javacall_app_id appID,
                                       javacall_change_reason reason) {
}
                                      
/**
 * Inform on change of the specific MIDlet's lifecycle status.
 *
 * Java will invoke this function whenever the running MIDlet has switched
 * to foreground or background.
 *
 * @param state new state of the running MIDlet. Can be either
 *        <tt>JAVACALL_MIDLET_UI_STATE_FOREGROUND</tt>,
 *        <tt>JAVACALL_MIDLET_UI_STATE_BACKGROUND</tt>,
 *        <tt>JAVACALL_MIDLET_UI_STATE_FOREGROUND_REQUEST</tt>,
 *        <tt>JAVACALL_MIDLET_UI_STATE_BACKGROUND_REQUEST</tt>.
 * @param appID The ID of the state-changed suite
 * @param reason The reason why the state change has happened
 */
void javacall_ams_midlet_ui_state_changed(javacall_midlet_ui_state state,
                                          javacall_app_id appID,
                                          javacall_change_reason reason) {
}

/**
 * Java invokes this function to get path name of the directory which
 * holds the suite's RMS files.
 *
 * The Platform must provide an implementation of this function if the
 * RMS is on the MIDP side.
 *
 * Note that memory for the parameter pRmsPath is allocated
 * by the callee. The caller is responsible for freeing it
 * using javacall_free().
 *
 * @param suiteId  [in]  unique ID of the MIDlet suite
 * @param pRmsPath [out] a place to hold a pointer to the buffer containing
 *                       the returned RMS path string.
 *                       The returned string must be double-'\0' terminated.
 *
 * @return <tt>JAVACALL_OK</tt> on success,
 *         <tt>JAVACALL_FAIL</tt>
 */
javacall_result
javacall_ams_get_rms_path(javacall_suite_id suiteId,
                          javacall_utf16_string* pRmsPath) {
    return JAVACALL_OK;
}

/**
 * Get domain information of the suite
 * @param suiteID Unique ID of the MIDlet suite
 * @param pDomain Pointer to a javacall_ext_ams_domain to contain returned
 *                domain information. Only Trusted or Untrusted domain is
 *                required to be returned.
 * @return <tt>JAVACALL_OK</tt> on success, 
 *         <tt>JAVACALL_FAIL</tt>
 */
javacall_result java_ams_get_domain(javacall_suite_id suiteID,
                                    javacall_ams_domain* pDomain) {
    return JAVACALL_OK;
}

/**
 * Get permission set of the suite
 * @param suiteID       Unique ID of the MIDlet suite
 * @param pPermissions  Pointer to a javacall_ext_ams_permission_set structure
 *                      to contain returned permission setttings
 * @return <tt>JAVACALL_OK</tt> on success, 
 *         <tt>JAVACALL_FAIL</tt>
 */
javacall_result
java_ams_get_permissions(javacall_suite_id suiteID,
                         javacall_ams_permission_set* pPermissions) {
    return JAVACALL_OK;
}

/**
 * Set single permission of the suite when user changed it.
 * @param suiteID     unique ID of the MIDlet suite
 * @param permission  permission be set
 * @param value       new value of permssion
 * @return <tt>JAVACALL_OK</tt> on success, 
 *         <tt>JAVACALL_FAIL</tt>
 */
javacall_result
java_ams_set_permission(javacall_suite_id suiteID,
                        javacall_ams_permission permission,
                        javacall_ams_permission_val value) {
    return JAVACALL_OK;
}

/**
 * Set permission set of the suite
 * @param suiteID       Unique ID of the MIDlet suite
 * @param pPermissions  Pointer to a javacall_ext_ams_permission_set structure
 *                      to contain returned permission setttings
 * @return <tt>JAVACALL_OK</tt> on success, 
 *         <tt>JAVACALL_FAIL</tt>
 */
javacall_result
java_ams_set_permissions(javacall_suite_id suiteID,
                         javacall_ams_permission_set* pPermissions) {
    return JAVACALL_OK;
}

/**
 * Get specified property value of the suite.
 * @param suiteID   Unique ID of the MIDlet suite
 * @param key       Property name
 * @param value     Buffer to conatain returned property value
 * @param maxValue  Buffern length of value
 * @return <tt>JAVACALL_OK</tt> on success, 
 *         <tt>JAVACALL_FAIL</tt>
 */
javacall_result
java_ams_get_suite_property(javacall_suite_id suiteID,
                            javacall_const_utf16_string key,
                            javacall_utf16_string value,
                            int maxValue) {
    return JAVACALL_OK;
}

/**
 * Get suite id by vendor and suite name.
 * @param vendorName  vendor name
 * @param suiteName   suite name
 * @param pSuiteID    return suiteID
 *
 * @return <tt>JAVACALL_OK</tt> on success, 
 *         <tt>JAVACALL_FAIL</tt>
 */
javacall_result
java_ams_get_suite_id(javacall_const_utf16_string vendorName,
                      javacall_const_utf16_string suiteName,
                      javacall_suite_id* pSuiteID) {
    return JAVACALL_OK;
}

/**
 * VM invokes this function to get the image cache path.
 * @param suiteID   unique ID of the MIDlet suite
 * @param cachePath buffer for Platform store the image cache path.
 * @param cachePathLen the length of cachePath
 *
 * @return <tt>JAVACALL_OK</tt> on success, 
 *         <tt>JAVACALL_FAIL</tt>
 */
javacall_result
javacall_ams_get_resource_cache_path(javacall_suite_id suiteID,
                                     javacall_utf16_string* pCachePath) {
    return JAVACALL_OK;
}