diff -r 09d0502090b3 -r 7d7f8cfa2b4f src/protocols/msn/slpmsg.h --- a/src/protocols/msn/slpmsg.h Sat Dec 11 00:06:06 2004 +0000 +++ b/src/protocols/msn/slpmsg.h Sat Dec 11 20:01:58 2004 +0000 @@ -34,11 +34,15 @@ #include "slp.h" +/** + * A SLP Message This contains everything that we will need to send a SLP + * Message even if has to be sent in several parts. + */ struct _MsnSlpMessage { MsnSlpSession *slpsession; - MsnSlpCall *slpcall; - MsnSlpLink *slplink; + MsnSlpCall *slpcall; /**< The slpcall to which this slp message belongs (if applicable). */ + MsnSlpLink *slplink; /**< The slplink through which this slp message is being sent. */ MsnSession *session; long session_id; @@ -48,10 +52,8 @@ long long ack_size; long app_id; - gboolean sip; -#if 0 - gboolean wasted; -#endif + gboolean sip; /**< A flag that states if this is a SIP slp message. */ + int ref_count; /**< The reference count. */ long flags; FILE *fp; @@ -59,16 +61,33 @@ long long offset; long long size; - MsnMessage *msg; /* The temporary real message that will be sent */ + GList *msgs; /**< The real messages. */ -#ifdef DEBUG_SLP +#if 1 + MsnMessage *msg; /**< The temporary real message that will be sent. */ +#endif + +#ifdef MSN_DEBUG_SLP char *info; gboolean text_body; #endif }; +/** + * Creates a new slp message + * + * @param slplink The slplink through which this slp message will be sent. + * @return The created slp message. + */ MsnSlpMessage *msn_slpmsg_new(MsnSlpLink *slplink); + +/** + * Destroys a slp message + * + * @param slpmsg The slp message to destory. + */ void msn_slpmsg_destroy(MsnSlpMessage *slpmsg); + void msn_slpmsg_set_body(MsnSlpMessage *slpmsg, const char *body, long long size); void msn_slpmsg_open_file(MsnSlpMessage *slpmsg, @@ -79,7 +98,7 @@ const char *content_type, const char *content); -#ifdef DEBUG_SLP +#ifdef MSN_DEBUG_SLP const void msn_slpmsg_show(MsnMessage *msg); #endif