Service-side Client interfaces

## Service-side Client interfaces Service-side Client interfaces — interfaces used to be an Observer, Approver and Handler |

## Synopsis

    #include <telepathy-glib/svc-client.h>

                        TpSvcClient;
                        TpSvcClientClass;

                        TpSvcClientApprover;
                        TpSvcClientApproverClass;
    void                tp_svc_client_approver_return_from_add_dispatch_operation
                                                            (DBusGMethodInvocation *context);
    void                (*tp_svc_client_approver_add_dispatch_operation_impl)
                                                            (TpSvcClientApprover *self,
                                                             const GPtrArray *in_Channels,
                                                             const gchar *in_DispatchOperation,
                                                             GHashTable *in_Properties,
                                                             DBusGMethodInvocation *context);
    void                tp_svc_client_approver_implement_add_dispatch_operation
                                                            (TpSvcClientApproverClass *klass,
                                                             tp_svc_client_approver_add_dispatch_operation_impl impl);

                        TpSvcClientHandler;
                        TpSvcClientHandlerClass;
    void                tp_svc_client_handler_return_from_handle_channels
                                                            (DBusGMethodInvocation *context);
    void                (*tp_svc_client_handler_handle_channels_impl)
                                                            (TpSvcClientHandler *self,
                                                             const gchar *in_Account,
                                                             const gchar *in_Connection,
                                                             const GPtrArray *in_Channels,
                                                             const GPtrArray *in_Requests_Satisfied,
                                                             guint64 in_User_Action_Time,
                                                             GHashTable *in_Handler_Info,
                                                             DBusGMethodInvocation *context);
    void                tp_svc_client_handler_implement_handle_channels
                                                            (TpSvcClientHandlerClass *klass,
                                                             tp_svc_client_handler_handle_channels_impl impl);
                        TpSvcClientInterfaceRequests;
                        TpSvcClientInterfaceRequestsClass;
    void                tp_svc_client_interface_requests_return_from_add_request
                                                            (DBusGMethodInvocation *context);
    void                (*tp_svc_client_interface_requests_add_request_impl)
                                                            (TpSvcClientInterfaceRequests *self,
                                                             const gchar *in_Request,
                                                             GHashTable *in_Properties,
                                                             DBusGMethodInvocation *context);
    void                tp_svc_client_interface_requests_implement_add_request
                                                            (TpSvcClientInterfaceRequestsClass *klass,
                                                             tp_svc_client_interface_requests_add_request_impl impl);
    void                tp_svc_client_interface_requests_return_from_remove_request
                                                            (DBusGMethodInvocation *context);
    void                (*tp_svc_client_interface_requests_remove_request_impl)
                                                            (TpSvcClientInterfaceRequests *self,
                                                             const gchar *in_Request,
                                                             const gchar *in_Error,
                                                             const gchar *in_Message,
                                                             DBusGMethodInvocation *context);
    void                tp_svc_client_interface_requests_implement_remove_request
                                                            (TpSvcClientInterfaceRequestsClass *klass,
                                                             tp_svc_client_interface_requests_remove_request_impl impl);

                        TpSvcClientObserver;
                        TpSvcClientObserverClass;
    void                tp_svc_client_observer_return_from_observe_channels
                                                            (DBusGMethodInvocation *context);
    void                (*tp_svc_client_observer_observe_channels_impl)
                                                            (TpSvcClientObserver *self,
                                                             const gchar *in_Account,
                                                             const gchar *in_Connection,
                                                             const GPtrArray *in_Channels,
                                                             const gchar *in_Dispatch_Operation,
                                                             const GPtrArray *in_Requests_Satisfied,
                                                             GHashTable *in_Observer_Info,
                                                             DBusGMethodInvocation *context);
    void                tp_svc_client_observer_implement_observe_channels
                                                            (TpSvcClientObserverClass *klass,
                                                             tp_svc_client_observer_observe_channels_impl impl);

## Object Hierarchy

      GInterface
       +----TpSvcClient

      GInterface
       +----TpSvcClientApprover

      GInterface
       +----TpSvcClientHandler

      GInterface
       +----TpSvcClientInterfaceRequests

      GInterface
       +----TpSvcClientObserver

## Description

These interfaces (auto-generated from the telepathy spec) make it easier to export the objects used to implement a Telepathy client.

Clients such as loggers, new message notification windows and chat UIs should implement some or all of the Client types (Observer, Approver and/or Handler): see telepathy-spec for details.

## Details

### TpSvcClient

    typedef struct _TpSvcClient TpSvcClient;

Dummy typedef representing any implementation of this interface.

### TpSvcClientClass

    typedef struct _TpSvcClientClass TpSvcClientClass;

The class of TpSvcClient. This interface has no D-Bus methods, so an implementation can typically pass `NULL` to `G_IMPLEMENT_INTERFACE()` as the interface initialization function.

### TpSvcClientApprover

    typedef struct _TpSvcClientApprover TpSvcClientApprover;

Dummy typedef representing any implementation of this interface.

### TpSvcClientApproverClass

    typedef struct _TpSvcClientApproverClass TpSvcClientApproverClass;

The class of TpSvcClientApprover.

In a full implementation of this interface (i.e. all methods implemented), the interface initialization function used in `G_IMPLEMENT_INTERFACE()` would typically look like this:

    static void
    implement_client_approver (gpointer klass,
        gpointer unused G_GNUC_UNUSED)
    {
    #define IMPLEMENT(x) tp_svc_client_approver_implement_##x (\
      klass, my_object_##x)
      IMPLEMENT (add_dispatch_operation);
    #undef IMPLEMENT
    }

### tp_svc_client_approver_return_from_add_dispatch_operation ()

    void                tp_svc_client_approver_return_from_add_dispatch_operation
                                                            (DBusGMethodInvocation *context);

Return successfully by calling `dbus_g_method_return()`. This inline function exists only to provide type-safety.

`context` : | The D-Bus method invocation context

### tp_svc_client_approver_add_dispatch_operation_impl ()

    void                (*tp_svc_client_approver_add_dispatch_operation_impl)
                                                            (TpSvcClientApprover *self,
                                                             const GPtrArray *in_Channels,
                                                             const gchar *in_DispatchOperation,
                                                             GHashTable *in_Properties,
                                                             DBusGMethodInvocation *context);

The signature of an implementation of the D-Bus method AddDispatchOperation on interface org.freedesktop.Telepathy.Client.Approver.

`self` : | The object implementing this interface
`in_Channels` : | const GPtrArray * (FIXME, generate documentation)
`in_DispatchOperation` : | const gchar * (FIXME, generate documentation)
`in_Properties` : | GHashTable * (FIXME, generate documentation)
`context` : | Used to return values or throw an error

### tp_svc_client_approver_implement_add_dispatch_operation ()

    void                tp_svc_client_approver_implement_add_dispatch_operation
                                                            (TpSvcClientApproverClass *klass,
                                                             tp_svc_client_approver_add_dispatch_operation_impl impl);

Register an implementation for the AddDispatchOperation method in the vtable of an implementation of this interface. To be called from the interface init function.

`klass` : | A class whose instances implement this interface
`impl` : | A callback used to implement the AddDispatchOperation D-Bus method

### TpSvcClientHandler

    typedef struct _TpSvcClientHandler TpSvcClientHandler;

Dummy typedef representing any implementation of this interface.

### TpSvcClientHandlerClass

    typedef struct _TpSvcClientHandlerClass TpSvcClientHandlerClass;

The class of TpSvcClientHandler.

In a full implementation of this interface (i.e. all methods implemented), the interface initialization function used in `G_IMPLEMENT_INTERFACE()` would typically look like this:

    static void
    implement_client_handler (gpointer klass,
        gpointer unused G_GNUC_UNUSED)
    {
    #define IMPLEMENT(x) tp_svc_client_handler_implement_##x (\
      klass, my_object_##x)
      IMPLEMENT (handle_channels);
    #undef IMPLEMENT
    }

### tp_svc_client_handler_return_from_handle_channels ()

    void                tp_svc_client_handler_return_from_handle_channels
                                                            (DBusGMethodInvocation *context);

Return successfully by calling `dbus_g_method_return()`. This inline function exists only to provide type-safety.

`context` : | The D-Bus method invocation context

### tp_svc_client_handler_handle_channels_impl ()

    void                (*tp_svc_client_handler_handle_channels_impl)
                                                            (TpSvcClientHandler *self,
                                                             const gchar *in_Account,
                                                             const gchar *in_Connection,
                                                             const GPtrArray *in_Channels,
                                                             const GPtrArray *in_Requests_Satisfied,
                                                             guint64 in_User_Action_Time,
                                                             GHashTable *in_Handler_Info,
                                                             DBusGMethodInvocation *context);

The signature of an implementation of the D-Bus method HandleChannels on interface org.freedesktop.Telepathy.Client.Handler.

`self` : | The object implementing this interface
`in_Account` : | const gchar * (FIXME, generate documentation)
`in_Connection` : | const gchar * (FIXME, generate documentation)
`in_Channels` : | const GPtrArray * (FIXME, generate documentation)
`in_Requests_Satisfied` : | const GPtrArray * (FIXME, generate documentation)
`in_User_Action_Time` : | guint64 (FIXME, generate documentation)
`in_Handler_Info` : | GHashTable * (FIXME, generate documentation)
`context` : | Used to return values or throw an error

### tp_svc_client_handler_implement_handle_channels ()

    void                tp_svc_client_handler_implement_handle_channels
                                                            (TpSvcClientHandlerClass *klass,
                                                             tp_svc_client_handler_handle_channels_impl impl);

Register an implementation for the HandleChannels method in the vtable of an implementation of this interface. To be called from the interface init function.

`klass` : | A class whose instances implement this interface
`impl` : | A callback used to implement the HandleChannels D-Bus method

### TpSvcClientInterfaceRequests

    typedef struct _TpSvcClientInterfaceRequests TpSvcClientInterfaceRequests;

Dummy typedef representing any implementation of this interface.

### TpSvcClientInterfaceRequestsClass

    typedef struct _TpSvcClientInterfaceRequestsClass TpSvcClientInterfaceRequestsClass;

The class of TpSvcClientInterfaceRequests.

In a full implementation of this interface (i.e. all methods implemented), the interface initialization function used in `G_IMPLEMENT_INTERFACE()` would typically look like this:

    static void
    implement_client_interface_requests (gpointer klass,
        gpointer unused G_GNUC_UNUSED)
    {
    #define IMPLEMENT(x) tp_svc_client_interface_requests_implement_##x (\
      klass, my_object_##x)
      IMPLEMENT (add_request);
      IMPLEMENT (remove_request);
    #undef IMPLEMENT
    }

### tp_svc_client_interface_requests_return_from_add_request ()

    void                tp_svc_client_interface_requests_return_from_add_request
                                                            (DBusGMethodInvocation *context);

Return successfully by calling `dbus_g_method_return()`. This inline function exists only to provide type-safety.

`context` : | The D-Bus method invocation context

### tp_svc_client_interface_requests_add_request_impl ()

    void                (*tp_svc_client_interface_requests_add_request_impl)
                                                            (TpSvcClientInterfaceRequests *self,
                                                             const gchar *in_Request,
                                                             GHashTable *in_Properties,
                                                             DBusGMethodInvocation *context);

The signature of an implementation of the D-Bus method AddRequest on interface org.freedesktop.Telepathy.Client.Interface.Requests.

`self` : | The object implementing this interface
`in_Request` : | const gchar * (FIXME, generate documentation)
`in_Properties` : | GHashTable * (FIXME, generate documentation)
`context` : | Used to return values or throw an error

### tp_svc_client_interface_requests_implement_add_request ()

    void                tp_svc_client_interface_requests_implement_add_request
                                                            (TpSvcClientInterfaceRequestsClass *klass,
                                                             tp_svc_client_interface_requests_add_request_impl impl);

Register an implementation for the AddRequest method in the vtable of an implementation of this interface. To be called from the interface init function.

`klass` : | A class whose instances implement this interface
`impl` : | A callback used to implement the AddRequest D-Bus method

### tp_svc_client_interface_requests_return_from_remove_request ()

    void                tp_svc_client_interface_requests_return_from_remove_request
                                                            (DBusGMethodInvocation *context);

Return successfully by calling `dbus_g_method_return()`. This inline function exists only to provide type-safety.

`context` : | The D-Bus method invocation context

### tp_svc_client_interface_requests_remove_request_impl ()

    void                (*tp_svc_client_interface_requests_remove_request_impl)
                                                            (TpSvcClientInterfaceRequests *self,
                                                             const gchar *in_Request,
                                                             const gchar *in_Error,
                                                             const gchar *in_Message,
                                                             DBusGMethodInvocation *context);

The signature of an implementation of the D-Bus method RemoveRequest on interface org.freedesktop.Telepathy.Client.Interface.Requests.

`self` : | The object implementing this interface
`in_Request` : | const gchar * (FIXME, generate documentation)
`in_Error` : | const gchar * (FIXME, generate documentation)
`in_Message` : | const gchar * (FIXME, generate documentation)
`context` : | Used to return values or throw an error

### tp_svc_client_interface_requests_implement_remove_request ()

    void                tp_svc_client_interface_requests_implement_remove_request
                                                            (TpSvcClientInterfaceRequestsClass *klass,
                                                             tp_svc_client_interface_requests_remove_request_impl impl);

Register an implementation for the RemoveRequest method in the vtable of an implementation of this interface. To be called from the interface init function.

`klass` : | A class whose instances implement this interface
`impl` : | A callback used to implement the RemoveRequest D-Bus method

### TpSvcClientObserver

    typedef struct _TpSvcClientObserver TpSvcClientObserver;

Dummy typedef representing any implementation of this interface.

### TpSvcClientObserverClass

    typedef struct _TpSvcClientObserverClass TpSvcClientObserverClass;

The class of TpSvcClientObserver.

In a full implementation of this interface (i.e. all methods implemented), the interface initialization function used in `G_IMPLEMENT_INTERFACE()` would typically look like this:

    static void
    implement_client_observer (gpointer klass,
        gpointer unused G_GNUC_UNUSED)
    {
    #define IMPLEMENT(x) tp_svc_client_observer_implement_##x (\
      klass, my_object_##x)
      IMPLEMENT (observe_channels);
    #undef IMPLEMENT
    }

### tp_svc_client_observer_return_from_observe_channels ()

    void                tp_svc_client_observer_return_from_observe_channels
                                                            (DBusGMethodInvocation *context);

Return successfully by calling `dbus_g_method_return()`. This inline function exists only to provide type-safety.

`context` : | The D-Bus method invocation context

### tp_svc_client_observer_observe_channels_impl ()

    void                (*tp_svc_client_observer_observe_channels_impl)
                                                            (TpSvcClientObserver *self,
                                                             const gchar *in_Account,
                                                             const gchar *in_Connection,
                                                             const GPtrArray *in_Channels,
                                                             const gchar *in_Dispatch_Operation,
                                                             const GPtrArray *in_Requests_Satisfied,
                                                             GHashTable *in_Observer_Info,
                                                             DBusGMethodInvocation *context);

The signature of an implementation of the D-Bus method ObserveChannels on interface org.freedesktop.Telepathy.Client.Observer.

`self` : | The object implementing this interface
`in_Account` : | const gchar * (FIXME, generate documentation)
`in_Connection` : | const gchar * (FIXME, generate documentation)
`in_Channels` : | const GPtrArray * (FIXME, generate documentation)
`in_Dispatch_Operation` : | const gchar * (FIXME, generate documentation)
`in_Requests_Satisfied` : | const GPtrArray * (FIXME, generate documentation)
`in_Observer_Info` : | GHashTable * (FIXME, generate documentation)
`context` : | Used to return values or throw an error

### tp_svc_client_observer_implement_observe_channels ()

    void                tp_svc_client_observer_implement_observe_channels
                                                            (TpSvcClientObserverClass *klass,
                                                             tp_svc_client_observer_observe_channels_impl impl);

Register an implementation for the ObserveChannels method in the vtable of an implementation of this interface. To be called from the interface init function.

`klass` : | A class whose instances implement this interface
`impl` : | A callback used to implement the ObserveChannels D-Bus method