|  |  |  | 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 : | TRUEfor pre-existing channels,FALSEfor 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