summaryrefslogtreecommitdiff
path: root/plugins/ExternalAPI/m_statusplugins.h
blob: b47a5fd5725e13a4ee1f5b04f2d5fde333ff026b (plain)
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
/*
    AdvancedAutoAway Plugin for Miranda-IM (www.miranda-im.org)
    KeepStatus Plugin for Miranda-IM (www.miranda-im.org)
    StartupStatus Plugin for Miranda-IM (www.miranda-im.org)
    Copyright 2003-2006 P. Boon

    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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/
#ifndef __M_STATUSPLUGINS
#define __M_STATUSPLUGINS

// -- common status -- (all three plugins)
typedef struct {
	char *m_szName;	// pointer to protocol modulename
	TCHAR *m_szMsg;	// pointer to the status message (may be NULL)
	WORD m_status;	// the status
	WORD m_lastStatus;// last status
	TCHAR *m_tszAccName;
} PROTOCOLSETTINGEX;

// wParam = PROTOCOLSETTINGEX*** (keep it like this for compatibility)
// lParam = 0
// returns 0 on success
#define MS_CS_SETSTATUSEX				"CommonStatus/SetStatusEx"

// wParam = 0
// lParam = 0
// returns the number of protocols registerd
#define MS_CS_GETPROTOCOUNT				"CommonStatus/GetProtocolCount" // added dec '04

// wParam = PROTOCOLSETTINGEX*** (keep it like this for compatibility)
// lParam = (int) settings count
#define ME_CS_STATUSCHANGEEX			"CommonStatus/StatusChangeEx"

// -- startup status --
// wParam = profile number (set to -1 to get default profile)
// lParam = PROTOCOLSETTINGEX***  (keep for... )(memory must be allocated protoCount*PROTOCOLSETTINGEX* and protoCount*PROTOCOLSETTINGEX)
// szMsg member does not have to be freed
// returns 0 on success
#define MS_SS_GETPROFILE				"StartupStatus/GetProfile" // don't use this > jan '05, internal use only

// wParam = profile number
// lParam = 0
// return 0 on success
#define MS_SS_LOADANDSETPROFILE			"StartupStatus/LoadAndSetProfile" // you can use this

// wParam = int*, maybe NULL sets this int to the default profile number
// lParam = 0
// returns profile count
#define MS_SS_GETPROFILECOUNT			"StartupStatus/GetProfileCount"

// wParam = profile number
// lParam = TCHAR* (must be allocated, size = 128)
// returns 0 on success
#define MS_SS_GETPROFILENAME			"StartupStatus/GetProfileName"


// -- KeepStatus --
#define KS_CONN_STATE_LOST				1		// lParam = protocol
#define KS_CONN_STATE_OTHERLOCATION		2		// lParam = protocol
#define KS_CONN_STATE_RETRY				3		// lParam = nth retry
#define KS_CONN_STATE_STOPPEDCHECKING	4		// lParam = TRUE if success, FALSE if failed
#define KS_CONN_STATE_LOGINERROR		5		// lParam = protocol, only if selected in options
#define KS_CONN_STATE_RETRYNOCONN		6		// lParam = nth try, a connection attempt will not be made
// wParam = one of above
// lParam depends on wParam
#define ME_KS_CONNECTIONEVENT			"KeepStatus/ConnectionEvent"

// wParam = 0
// lParam = 0
// returns 0 on succes, nonzero on failure, probably keepstatus wasn't reconnecting
#define MS_KS_STOPRECONNECTING			"KeepStatus/StopReconnecting"

// wParam = TRUE to enable checking a protocol, FALSE to disable checking a protocol
// lParam = protocol
// return 0 on success, nonzero on failure, probably the protocol is 'hard' disabled or not found
// note: you cannot enable a protocol that is disabled in the options screen, you can disable a protocol
// if it's enabled in the option screen.
#define MS_KS_ENABLEPROTOCOL			"KeepStatus/EnableProtocol"

// wParam = 0
// lParam = protocol
// returns TRUE if protocol is enabled for checked, FALSE otherwise
#define MS_KS_ISPROTOCOLENABLED			"KeepStatus/IsProtocolEnabled"

// Indicate the status will be changed which will not be regarded as a connection failure.
// wParam = 0
// lParam = PROTOCOLSETTINGEX* of the new situation
// returns 0
#define MS_KS_ANNOUNCESTATUSCHANGE		"KeepStatus/AnnounceStatusChange"

__inline static int announce_status_change(char *szProto, int newstatus, TCHAR *szMsg) {

	PROTOCOLSETTINGEX ps = { 0 };
	ps.m_lastStatus = szProto != nullptr ? CallProtoService(szProto, PS_GETSTATUS, 0, 0) : CallService(MS_CLIST_GETSTATUSMODE, 0, 0);
	ps.m_status = newstatus;
	ps.m_szMsg = szMsg;
	ps.m_szName = szProto;
	return CallService(MS_KS_ANNOUNCESTATUSCHANGE, 0, (LPARAM)&ps);
}

#endif // __M_STATUSPLUGINS