-
Notifications
You must be signed in to change notification settings - Fork 0
/
transaction.h
87 lines (72 loc) · 3.03 KB
/
transaction.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
/**
* @file transaction.h MSN transaction functions
*
* purple
*
* Purple is the legal property of its developers, whose names are too numerous
* to list here. Please refer to the COPYRIGHT file distributed with this
* source distribution.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
*/
#ifndef MSN_TRANSACTION_H
#define MSN_TRANSACTION_H
#include "internal.h"
typedef struct _MsnTransaction MsnTransaction;
#include "cmdproc.h"
#include "command.h"
typedef void (*MsnTransCb)(MsnCmdProc *cmdproc, MsnCommand *cmd);
typedef void (*MsnTimeoutCb)(MsnCmdProc *cmdproc, MsnTransaction *trans);
typedef void (*MsnErrorCb)(MsnCmdProc *cmdproc, MsnTransaction *trans,
int error);
/**
* A transaction. A sending command that will initiate the transaction.
*/
struct _MsnTransaction
{
MsnCmdProc *cmdproc;
gboolean saveable; /**< Whether to save this transaction in the history */
unsigned int trId; /**< The ID of this transaction, if it's being saved */
char *command;
char *params;
guint timer;
void *data; /**< The data to be used on the different callbacks. */
GDestroyNotify data_free; /**< The function to free 'data', or @c NULL */
GHashTable *callbacks;
gboolean has_custom_callbacks;
MsnErrorCb error_cb;
MsnTimeoutCb timeout_cb;
char *payload;
size_t payload_len;
GQueue *queue;
MsnCommand *pendent_cmd; /**< The command that is waiting for the result of
this transaction. */
};
MsnTransaction *msn_transaction_new(MsnCmdProc *cmdproc, const char *command,
const char *format, ...) G_GNUC_PRINTF(3, 4);
void msn_transaction_destroy(MsnTransaction *trans);
char *msn_transaction_to_string(MsnTransaction *trans);
void msn_transaction_queue_cmd(MsnTransaction *trans, MsnCommand *cmd);
void msn_transaction_unqueue_cmd(MsnTransaction *trans, MsnCmdProc *cmdproc);
void msn_transaction_set_payload(MsnTransaction *trans,
const char *payload, gsize payload_len);
void msn_transaction_set_data(MsnTransaction *trans, void *data);
void msn_transaction_set_data_free(MsnTransaction *trans, GDestroyNotify fn);
void msn_transaction_set_saveable(MsnTransaction *trans, gboolean saveable);
void msn_transaction_add_cb(MsnTransaction *trans, char *answer,
MsnTransCb cb);
void msn_transaction_set_error_cb(MsnTransaction *trans, MsnErrorCb cb);
void msn_transaction_set_timeout_cb(MsnTransaction *trans, MsnTimeoutCb cb);
#endif /* MSN_TRANSACTION_H */