Connection and Channel ServicePoint interfaces: telepathy-glib API Reference Manual

## Connection and Channel ServicePoint interfaces Connection and Channel ServicePoint interfaces — client-side wrappers for the ServicePoint interfaces |

## Functions

TpProxySignalConnection * | tp_cli_channel_interface_service_point_connect_to_service_point_changed ()
void | (*tp_cli_channel_interface_service_point_signal_callback_service_point_changed) ()
TpProxySignalConnection * | tp_cli_connection_interface_service_point_connect_to_service_points_changed ()
void | (*tp_cli_connection_interface_service_point_signal_callback_service_points_changed) ()

## Includes

    #include <telepathy-glib/telepathy-glib-dbus.h>

## Description

In some protocols, mainly those that interact with the PSTN, it's possible to contact the emergency services or other public service answering points. The ServicePoint interfaces on the Connection and Channel can be used to discover how to contact these service points, and detect whether a call in progress is communicating with a service point.

This section documents the auto-generated C wrappers for the ServicePoint interfaces, used with TpConnection and TpChannel objects.

## Functions

### tp_cli_channel_interface_service_point_connect_to_service_point_changed ()

    TpProxySignalConnection *
    tp_cli_channel_interface_service_point_connect_to_service_point_changed
                                   (TpChannel *proxy,
                                    tp_cli_channel_interface_service_point_signal_callback_service_point_changed callback,
                                    gpointer user_data,
                                    GDestroyNotify destroy,
                                    GObject *weak_object,
                                    GError **error);

Connect a handler to the signal ServicePointChanged.

<p>Emitted when a channel changes the service point that it's connected to. This might be a new call being connected to a service, a call connected to a service being routed to a different service (ie, an emergency call being routed from a generic emergency PSAP to a poison control PSAP), or any number of other things.</p> <p>Note that this should be emitted as soon as the CM has been notified of the switch, and has updated its internal state. The CM MAY still be in the process of connecting to the new service point.</p>

#### Parameters

proxy | A TpChannel or subclass |
callback | Callback to be called when the signal is received |
user_data | User-supplied data for the callback |
destroy | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL` |
weak_object | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected |
error | If not `NULL`, used to raise an error if `NULL` is returned |

#### Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_channel_interface_service_point_signal_callback_service_point_changed ()

    void
    (*tp_cli_channel_interface_service_point_signal_callback_service_point_changed)
                                   (TpChannel *proxy,
                                    const GValueArray *arg_Service_Point,
                                    gpointer user_data,
                                    GObject *weak_object);

Represents the signature of a callback for the signal ServicePointChanged.

#### Parameters

proxy | The proxy on which `tp_cli_channel_interface_service_point_connect_to_service_point_changed()` was called |
arg_Service_Point | The new service point that is being used. |
user_data | User-supplied data |
weak_object | User-supplied weakly referenced object |

### tp_cli_connection_interface_service_point_connect_to_service_points_changed ()

    TpProxySignalConnection *
    tp_cli_connection_interface_service_point_connect_to_service_points_changed
                                   (TpConnection *proxy,
                                    tp_cli_connection_interface_service_point_signal_callback_service_points_changed callback,
                                    gpointer user_data,
                                    GDestroyNotify destroy,
                                    GObject *weak_object,
                                    GError **error);

Connect a handler to the signal ServicePointsChanged.

Emitted when the list of known service points (or their IDs) has changed.

#### Parameters

proxy | A TpConnection or subclass |
callback | Callback to be called when the signal is received |
user_data | User-supplied data for the callback |
destroy | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL` |
weak_object | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected |
error | If not `NULL`, used to raise an error if `NULL` is returned |

#### Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_connection_interface_service_point_signal_callback_service_points_changed ()

    void
    (*tp_cli_connection_interface_service_point_signal_callback_service_points_changed)
                                   (TpConnection *proxy,
                                    const GPtrArray *arg_Service_Points,
                                    gpointer user_data,
                                    GObject *weak_object);

Represents the signature of a callback for the signal ServicePointsChanged.

#### Parameters

proxy | The proxy on which `tp_cli_connection_interface_service_point_connect_to_service_points_changed()` was called |
arg_Service_Points | <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The new value of <tp:member-ref>KnownServicePoints</tp:member-ref>.</p> |
user_data | User-supplied data |
weak_object | User-supplied weakly referenced object |

## See Also

TpConnection, TpChannel