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