STW TC1, User Manual

Page: 166 / 374

7 Teleservice Application Framework
User Manual 166/374
7.3.5.2.5 ydatad_get_datapool_base_path
Function Description
sint32 ydatad_get_datapool_base_path (const T_DBUS_Util *const opt_DBusInstance, charn *
const opcn_BasePath, const sint32 os32_Size)
This function returns the base path of all data pools on the system, as configured in the ydatad configuration
file. The maximum length of opcn_BaseBath is defined with the variable os32_Size.
Information Flow
Input Information
Parameter Range Description
opt_DBusInstance T_DBUS_Util holds all D-Bus information
os32_Size minimum
MAX_DP_BASEFOLDER_LENGHT includes the buffer size of the base path
Output Information
Parameter Range Description
opcn_BasePath os32_Size pointer to base path
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.)
charn acn_myStatus[128]; // Additional value (for HELLO) signal (opt.)
charn acn_myAddInfo[512]; // Additional value (for HELLO) signal (opt.)
sint32 s32_myTriginterval; // Time interval when the ysysd
// expects to be triggered
charn acn_myCMDOnWatchdog[2048]; // Bash cmd that must be executed
// by the ysysd in case no
// trigger signal occurred in time.
} T_DBUS_Util;
Output Information
Return Value Description
C_NO_ERR Function executed without error, base path was returned successful
C_UNKNOWN_ERR Error sending the method call or NULL pointer
C_COM Error receiving the method call answer