Top |
Connection and Channel ServicePoint interfacesConnection and Channel ServicePoint interfaces — client-side wrappers for the ServicePoint interfaces |
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.
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>
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 |
|
weak_object |
A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected |
|
error |
If not |
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.
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.
proxy |
The proxy on which |
|
arg_Service_Point |
The new service point that is being used. |
|
user_data |
User-supplied data |
|
weak_object |
User-supplied weakly referenced object |
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.
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 |
|
weak_object |
A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected |
|
error |
If not |
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.
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.
proxy |
The proxy on which |
|
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 |