diff -r d0f3a028347a -r 59927b2d3b75 isolationserver/isoserver/inc/isomodifycontactlist.h --- a/isolationserver/isoserver/inc/isomodifycontactlist.h Tue Feb 02 01:10:06 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,159 +0,0 @@ - -/* ============================================================================ -* Name : isomodifycontacts.h -* Part of : isolation server. -* Version : %version: 7 % -* -* Copyright © 2007-2008 Nokia. All rights reserved. -* All rights reserved. -* Redistribution and use in source and binary forms, with or without modification, -* are permitted provided that the following conditions are met: -* Redistributions of source code must retain the above copyright notice, this list -* of conditions and the following disclaimer.Redistributions in binary form must -* reproduce the above copyright notice, this list of conditions and the following -* disclaimer in the documentation and/or other materials provided with the distribution. -* Neither the name of the Nokia Corporation nor the names of its contributors may be used -* to endorse or promote products derived from this software without specific prior written -* permission. -* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY -* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES -* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT -* SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT -* OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, -* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -* ============================================================================ -* Template version: 1.0 -*/ - -/*! -* /def To avoid multiple inclusion of header -*/ -#ifndef __ISOADDCONTACTS_H__ -#define __ISOADDCONTACTS_H__ - -#include "tp-conn.h" -#include "tp-connmgr.h" -#include "tp-chan.h" -#include "tp-chan-gen.h" -#include "tp-ch-gen.h" -#include "tp-chan-iface-group-gen.h" -#include "tp-chan-type-text-gen.h" -#include "tp-chan-type-streamed-media-gen.h" -#include "tp-props-iface.h" -#include "tp-constants.h" -#include "tp-interfaces.h" - -#include "isoim.h" - -/*! /file - * Interfaces for the maintainence of the contact list. - * client anywhere in the documentation refers to anyone - * using the isoserver - */ - -/*! - * /brief This function is called by message_send_recv function in isoservermain.c if message type - * is EReject_Contact_Request, EAccept_Contact_Request, EAdd_Contact_Request and EDelete_Contact_Request. - * Contacts added/removed to/from list. This function parses the message buffer, - * validates for the arguments and calls modify_contact_list to add/remove contacts - * - * /param buf : buffer to be parsed - * /param buf_len : buffer length - * /return : error code if any, 0 on success - */ -gint action_parse_modify_contact_list( gchar* buf, gint buf_len ) ; - -/*! - * /brief gets the handles for contacts. Handles are returned in request_modify_contact_list_handles_cb - * callback which is an arg for the async request to get handles. - * - * /param msg_hdr : The header and message passed to callbacks - * /param contact_id : contact ids whose handles to be returned - * /param no_cntcts : total no. of contacts to be added - * /return : error code if any, handle on success - */ -guint get_handles_for_contacts ( send_msg_struct* msg_hdr, - const gchar **contact_id, gint no_cntcts ); - -/*! - * /brief Handles are returned in this callback. Which will then actually do modify - * the contact list based on the request type(add/remove/accept/reject) - * modify_contact_list_cb is registered as the callback. - * - * /param proxy : unused - * /param handles : handles of the contacts - * /param error : error if any - * /param message : userdata(send_msg_struct) passed back - * /return : error code if any, handle on success - */ -void request_modify_contact_list_handles_cb( DBusGProxy *proxy, GArray *handles, - GError* error, gpointer message ); - -/*! - * /brief Calls get_handles_for_contacts to get the handles for contact. - * - * /param msg_hdr : message request header passed to callbacks - * /param contact_id : contact ids to be added - * /param message : messgae if any - * /param no_cntcts : no of contacts to be added - * /return void - */ -gint modify_contact_list ( send_msg_struct* msg_hdr, const gchar **contact_ids, - gint no_cntcts ); - -/*! - * /brief called as callback for request for modify contact list - * This function then sends the result to client - * - * /param proxy unused - * /param error Error if any - * /param userdata request message header - * /return void - */ -void modify_contact_list_cb( DBusGProxy *proxy, GError *error, gpointer userdata ); - -/*! - * /brief The contact names corresponding to the contact handles that are changed - * are passed to the client - * /param proxy - * /param handles_name - * /param error - * /param userdata - * /return void - */ -static void rosters_changed_contacts_cb( DBusGProxy *proxy, - gchar **handles_names, GError *error, gpointer userdata ); - - -/*! /brief Whenever contact list is changed by others( someone trying to add this user - * or someone rejecting the add request etc., ) this callback registered as a signal - * is called with the handles of the changed contacts. rosters_changed_contacts_cb is - * passed as callback to get the contact name of the changed handles - * - * /param group_iface unused - * /param message unused - * /param added List of contacts that are recently added - * /param removed List of contacts that were recently removed - * /param local_pending List of contacts that are locally pending for approval - * /param remote_pending List of contacts that are remotely pending for approval - * /param actor unused - * /param reason unused - * /param userdata unused - * /return void - */ -void roster_members_changed_cb ( DBusGProxy *group_iface, - gchar *message, - GArray *added, - GArray *removed, - GArray *local_pending, - GArray *remote_pending, - guint actor, - guint reason, - gpointer userdata ); - - - -#endif //__ISOADDCONTACTS_H__ \ No newline at end of file