| telepathy-glib API Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
#include <telepathy-glib/telepathy-glib.h>
TpObserveChannelsContext;
void tp_observe_channels_context_accept (TpObserveChannelsContext *self);
void tp_observe_channels_context_delay (TpObserveChannelsContext *self);
void tp_observe_channels_context_fail (TpObserveChannelsContext *self,
const GError *error);
gboolean tp_observe_channels_context_is_recovering
(TpObserveChannelsContext *self);
GList * tp_observe_channels_context_get_requests
(TpObserveChannelsContext *self);
"account" TpAccount* : Read / Write / Construct Only "channels" GPtrArray* : Read / Write / Construct Only "connection" TpConnection* : Read / Write / Construct Only "dbus-context" gpointer : Write / Construct Only "dispatch-operation" TpChannelDispatchOperation* : Read / Write / Construct Only "observer-info" GHashTable_gchararray+GValue_* : Read / Write / Construct Only "requests" GPtrArray* : Read / Write / Construct Only
Object used to represent the context of a Observer.ObserveChannels() D-Bus call on a TpBaseClient.
typedef struct _TpObserveChannelsContext TpObserveChannelsContext;
Data structure representing the context of a Observer.ObserveChannels() call.
Since 0.11.5
void tp_observe_channels_context_accept (TpObserveChannelsContext *self);
Called by TpBaseClientClassObserveChannelsImpl when it's done so the D-Bus method can return.
|
a TpObserveChannelsContext |
Since 0.11.5
void tp_observe_channels_context_delay (TpObserveChannelsContext *self);
Called by TpBaseClientClassObserveChannelsImpl to indicate that it
implements the method in an async way. The caller must take a reference
to the TpObserveChannelsContext before calling this function, and
is responsible for calling either tp_observe_channels_context_accept() or
tp_observe_channels_context_fail() later.
|
a TpObserveChannelsContext |
Since 0.11.5
void tp_observe_channels_context_fail (TpObserveChannelsContext *self,const GError *error);
Called by TpBaseClientClassObserveChannelsImpl to raise a D-Bus error.
|
a TpObserveChannelsContext |
|
the error to return from the method |
Since 0.11.5
gboolean tp_observe_channels_context_is_recovering
(TpObserveChannelsContext *self);
If this call to ObserveChannels is for channels that already
existed before this observer started (because the observer used
tp_base_client_set_observer_recover()), return TRUE.
In most cases, the result is FALSE.
|
a TpObserveChannelsContext |
Returns : |
TRUE for pre-existing channels, FALSE for new channels |
Since 0.11.5
GList * tp_observe_channels_context_get_requests
(TpObserveChannelsContext *self);
Return a list of the TpChannelRequest which have been satisfied by the channels associated with self.
|
a TpObserveChannelsContext |
Returns : |
a newly allocated GList of reffed TpChannelRequest. [transfer full][element-type TelepathyGLib.ChannelRequest] |
Since 0.13.14
"account" property"account" TpAccount* : Read / Write / Construct Only
A TpAccount object representing the Account that has been passed to ObserveChannels. Read-only except during construction.
This property can't be NULL.
Since 0.11.5
"channels" property"channels" GPtrArray* : Read / Write / Construct Only
A GPtrArray containing TpChannel objects representing the channels that have been passed to ObserveChannels. Read-only except during construction.
This property can't be NULL.
Since 0.11.5
"connection" property"connection" TpConnection* : Read / Write / Construct Only
A TpConnection object representing the Connection that has been passed to ObserveChannels. Read-only except during construction.
This property can't be NULL.
Since 0.11.5
"dbus-context" property"dbus-context" gpointer : Write / Construct Only
The DBusGMethodInvocation representing the D-Bus context of the ObserveChannels call. Can only be written during construction.
Since 0.11.5
"dispatch-operation" property"dispatch-operation" TpChannelDispatchOperation* : Read / Write / Construct Only
A TpChannelDispatchOperation object representing the
ChannelDispatchOperation that has been passed to ObserveChannels,
or NULL if none has been passed.
Read-only except during construction.
Since 0.11.5
"observer-info" property "observer-info" GHashTable_gchararray+GValue_* : Read / Write / Construct Only
A GHashTable where the keys are string and values are GValue instances.
It represents the Observer_Info hash table that has been passed to
ObserveChannels.
It's recommended to use high-level method such as
tp_observe_channels_context_is_recovering() to access to its content.
This property can't be NULL.
Since 0.11.5
"requests" property"requests" GPtrArray* : Read / Write / Construct Only
A GPtrArray containing TpChannelRequest objects representing the requests that have been passed to ObserveChannels. Read-only except during construction.
This property can't be NULL.
Since 0.11.5