STW TC1, User Manual

Page: 167 / 374

7 Teleservice Application Framework
User Manual 167/374
Return Value Description
C_NOACT Reply error from bus, can't get data pool base path
C_RANGE Size of base path array is to small
Example
// Global module
T_DBUS_Util mt_DBUS_Util;
sint32 s32_Retval;
charn acn_Value[256];
s32_Retval = ydatad_get_datapool_base_path (&mt_DBUS_Util, acn_Value, sizeof (acn_Value));
if (s32_Retval == C_NO_ERR)
{
// Go on
}
7.3.5.2.6 ydatad_init_datapool
Function Description
sint32 ydatad_init_datapool (const T_DBUS_Util *const opt_DBusInstance, charn * const
opcn_Datapool)
The function initializes the data pool ocn_Datapool. Before initializing the data pool, all lists within the data pool
have to be initialized. After initialization, it isn't possible to add more lists to the initialized data pool. The ydata
daemon creates a file in the named data pool subdirectory with the extension ".dpi". This file contains the
information about the created data pool.
Information Flow
Input Information
Parameter Range Description
opt_DBusInstance T_DBUS_Util holds all D-BUS information
opcn_Datapool maximum
MAX_DP_NAME_LENGTH pointer to the name of the data pool
Structure T_DBUS_Util
typedef struct
{
DBusConnection* pt_dbus_conn;
// D-BUS connection instance
charn acn_myNameString[128]; // Name of the application, Don't use any
special
// characters, white spaces or new lines!
charn acn_myVersion[128]; // Additional value (for HELLO) signal (opt.)
NOTE:
The data pool can only be initialized if minimum one variable was add to the variable list.