STW TC1, User Manual

Page: 138 / 374

7 Teleservice Application Framework
User Manual 138/374
Output Information
Return Value Description
C_NO_ERR Function executed without error. "Hello" signal was successful sent
C_UNKNOWN_ERR D-Bus signal sent, out of memory error
C_CONFIG D-Bus message append argument error
C_RANGE opt_DBusInstance is a NULL pointer
Example
// Global module
T_DBUS_Util mt_DBUS_Util;
sint32 s32_Retval;
// Basic initialization (see " Introduction " on page 133) for TAF communication
// ...
s32_Retval = dbus_send_hello_signal (&mt_DBUS_Util);
if (s32_Retval != C_NO_ERR)
{
// Handle error cases
}
7.3.3.6 dbus_send_goodbye_signal
Function Description
sint32 dbus_send_goodbye_signal ( const T_DBUS_Util * const opt_DBusInstance )
This function informs other application over D-Bus that your application will be closed.
The function creates a goodbye signal and sends it over the D-Bus so other applications can listen.
Use this function to ensure the presence of cooperating applications. The use of the goodbye signal is not
mandatory.
Information Flow
Input Information
Parameter Range Description
opt_DBusInstance T_DBUS_Util holds all information regarding the D-Bus
connection instance