arm_subbuffer_app_context Struct Reference [ARM 4.0 Properties, ARM 4.0 Sub-buffers]

used to associate context properties to an application instance. More...

#include <arm4.h>

Data Fields
arm_subbuffer_t	header
arm_int32_t	context_value_count
const arm_char_t **	context_value_array

---

Detailed Description

used to associate context properties to an application instance.

Applications are identified by a name and an optional set of identity attribute (name,value) pairs. Application instances are further identified by an optional set of context (name,value) pairs. These properties could indicate something about the runtime instance of the application, such as the instance identifier and the name of a configuration file used.

The optional context property names are provided in the Application Identity sub-buffer (arm_subbuffer_app_identity_t) on the arm_register_application() call. The optional context property values are provided in this sub-buffer on the arm_start_application() call. The sub-buffer is ignored if it is passed on any other call.

---

Field Documentation

const arm_char_t** arm_subbuffer_app_context::context_value_array

An array of pointers to character strings containing the property values. The values in the array are position-sensitive; each must align with the corresponding context property name in the Application Identity (arm_subbuffer_app_identity_t) sub-buffer. If the corresponding property name pointer is null or points to a zero-length string, the value is ignored. Each pointer is aligned as required for the C compiler on the platform. Each array element contains:

• Value: A null-terminated string representing the value part of the (name,value) pair. Each string has a maximum length of 256 characters, including the termination character. If any pointer is null or points to a zero-length string, the meaning is that there is no value for this instance. The value should not contain trailing blank characters or consist of only blank characters.

arm_int32_t arm_subbuffer_app_context::context_value_count

count of context values in the following array.

arm_subbuffer_t arm_subbuffer_app_context::header

header.format must be set to ARM_SUBBUFFER_APP_CONTEXT

---

The documentation for this struct was generated from the following file:

• arm4.h