Frameworks/libpurple.framework/Versions/0.6.2/Headers/slplink.h
author Zachary West <zacw@adium.im>
Fri Aug 21 13:25:11 2009 -0700 (2009-08-21)
changeset 2592 e8d15275025e
parent 1739 Frameworks/libpurple.framework/Versions/0.6.0/Headers/slplink.h@8b0daad9656c
permissions -rw-r--r--
im.pidgin.adium.1-4 at 267c6165e02e34318a1823960bd04c0639952f73
     1 /**
     2  * @file slplink.h MSNSLP Link support
     3  *
     4  * purple
     5  *
     6  * Purple is the legal property of its developers, whose names are too numerous
     7  * to list here.  Please refer to the COPYRIGHT file distributed with this
     8  * source distribution.
     9  *
    10  * This program is free software; you can redistribute it and/or modify
    11  * it under the terms of the GNU General Public License as published by
    12  * the Free Software Foundation; either version 2 of the License, or
    13  * (at your option) any later version.
    14  *
    15  * This program is distributed in the hope that it will be useful,
    16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
    17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    18  * GNU General Public License for more details.
    19  *
    20  * You should have received a copy of the GNU General Public License
    21  * along with this program; if not, write to the Free Software
    22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
    23  */
    24 #ifndef _MSN_SLPLINK_H_
    25 #define _MSN_SLPLINK_H_
    26 
    27 typedef struct _MsnSlpLink MsnSlpLink;
    28 
    29 #include "directconn.h"
    30 #include "slpcall.h"
    31 #include "slpmsg.h"
    32 
    33 #include "switchboard.h"
    34 
    35 #include "ft.h"
    36 
    37 #include "session.h"
    38 
    39 typedef void (*MsnSlpCb)(MsnSlpCall *slpcall,
    40 						 const guchar *data, gsize size);
    41 typedef void (*MsnSlpEndCb)(MsnSlpCall *slpcall, MsnSession *session);
    42 
    43 struct _MsnSlpLink
    44 {
    45 	MsnSession *session;
    46 	MsnSwitchBoard *swboard;
    47 
    48 	char *remote_user;
    49 
    50 	int slp_seq_id;
    51 
    52 	MsnDirectConn *directconn;
    53 
    54 	GList *slp_calls;
    55 	GList *slp_msgs;
    56 
    57 	GQueue *slp_msg_queue;
    58 };
    59 
    60 void msn_slplink_destroy(MsnSlpLink *slplink);
    61 
    62 /**
    63  * @return An MsnSlpLink for the given user, or NULL if there is no
    64  *         existing MsnSlpLink.
    65  */
    66 MsnSlpLink *msn_session_find_slplink(MsnSession *session,
    67 									 const char *who);
    68 
    69 /**
    70  * @return An MsnSlpLink for the given user.  One will be created if
    71  *         it does not already exist.
    72  */
    73 MsnSlpLink *msn_session_get_slplink(MsnSession *session, const char *username);
    74 
    75 void msn_slplink_add_slpcall(MsnSlpLink *slplink, MsnSlpCall *slpcall);
    76 void msn_slplink_remove_slpcall(MsnSlpLink *slplink, MsnSlpCall *slpcall);
    77 MsnSlpCall *msn_slplink_find_slp_call(MsnSlpLink *slplink,
    78 									  const char *id);
    79 MsnSlpCall *msn_slplink_find_slp_call_with_session_id(MsnSlpLink *slplink, long id);
    80 void msn_slplink_queue_slpmsg(MsnSlpLink *slplink, MsnSlpMessage *slpmsg);
    81 void msn_slplink_send_slpmsg(MsnSlpLink *slplink,
    82 							 MsnSlpMessage *slpmsg);
    83 void msn_slplink_send_queued_slpmsgs(MsnSlpLink *slplink);
    84 void msn_slplink_process_msg(MsnSlpLink *slplink, MsnMessage *msg);
    85 void msn_slplink_request_ft(MsnSlpLink *slplink, PurpleXfer *xfer);
    86 
    87 void msn_slplink_request_object(MsnSlpLink *slplink,
    88 								const char *info,
    89 								MsnSlpCb cb,
    90 								MsnSlpEndCb end_cb,
    91 								const MsnObject *obj);
    92 
    93 MsnSlpCall *msn_slp_process_msg(MsnSlpLink *slplink, MsnSlpMessage *slpmsg);
    94 
    95 #endif /* _MSN_SLPLINK_H_ */