moving API to ExternalAPI folder

git-svn-id: http://svn.miranda-ng.org/main/trunk@34 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c

4 files changed, 4 insertions, 561 deletions

diff --git a/protocols/IcqOscarJ/icqoscar8_10.vcxproj b/protocols/IcqOscarJ/icqoscar8_10.vcxproj
index 837f341878..ad693d2dde 100644
--- a/protocols/IcqOscarJ/icqoscar8_10.vcxproj
+++ b/protocols/IcqOscarJ/icqoscar8_10.vcxproj
@@ -105,7 +105,7 @@
     </Midl>

     <ClCompile>

       <Optimization>Disabled</Optimization>

-      <AdditionalIncludeDirectories>../../include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

+      <AdditionalIncludeDirectories>../../include;../../plugins/ExternalAPI;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

       <PreprocessorDefinitions>WIN32;_DEBUG;_WINDOWS;_USRDLL;icqoscar8_EXPORTS;%(PreprocessorDefinitions)</PreprocessorDefinitions>

       <BasicRuntimeChecks>EnableFastChecks</BasicRuntimeChecks>

       <RuntimeLibrary>MultiThreadedDebugDLL</RuntimeLibrary>

@@ -150,7 +150,7 @@
     </Midl>

     <ClCompile>

       <Optimization>Disabled</Optimization>

-      <AdditionalIncludeDirectories>../../include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

+      <AdditionalIncludeDirectories>../../include;../../plugins/ExternalAPI;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

       <PreprocessorDefinitions>WIN32;_DEBUG;_WINDOWS;_USRDLL;icqoscar8_EXPORTS;%(PreprocessorDefinitions)</PreprocessorDefinitions>

       <BasicRuntimeChecks>EnableFastChecks</BasicRuntimeChecks>

       <RuntimeLibrary>MultiThreadedDebugDLL</RuntimeLibrary>

@@ -200,7 +200,7 @@
       <IntrinsicFunctions>true</IntrinsicFunctions>

       <FavorSizeOrSpeed>Size</FavorSizeOrSpeed>

       <WholeProgramOptimization>true</WholeProgramOptimization>

-      <AdditionalIncludeDirectories>../../include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

+      <AdditionalIncludeDirectories>../../include;../../plugins/ExternalAPI;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

       <PreprocessorDefinitions>WIN32;NDEBUG;_WINDOWS;_USRDLL;icqoscar8_EXPORTS;%(PreprocessorDefinitions)</PreprocessorDefinitions>

       <StringPooling>true</StringPooling>

       <ExceptionHandling>false</ExceptionHandling>

@@ -251,7 +251,7 @@
       <IntrinsicFunctions>true</IntrinsicFunctions>

       <FavorSizeOrSpeed>Size</FavorSizeOrSpeed>

       <WholeProgramOptimization>true</WholeProgramOptimization>

-      <AdditionalIncludeDirectories>../../include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

+      <AdditionalIncludeDirectories>../../include;../../plugins/ExternalAPI;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

       <PreprocessorDefinitions>WIN32;NDEBUG;_WINDOWS;_USRDLL;icqoscar8_EXPORTS;%(PreprocessorDefinitions)</PreprocessorDefinitions>

       <StringPooling>true</StringPooling>

       <ExceptionHandling>false</ExceptionHandling>

diff --git a/protocols/IcqOscarJ/m_extraicons.h b/protocols/IcqOscarJ/m_extraicons.h
deleted file mode 100644
index 589d040cef..0000000000
--- a/protocols/IcqOscarJ/m_extraicons.h
+++ /dev/null
@@ -1,158 +0,0 @@
-/*

- Copyright (C) 2009 Ricardo Pescuma Domenecci

-

- This is free software; you can redistribute it and/or

- modify it under the terms of the GNU Library General Public

- License as published by the Free Software Foundation; either

- version 2 of the License, or (at your option) any later version.

-

- This 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

- Library General Public License for more details.

-

- You should have received a copy of the GNU Library General Public

- License along with this file; see the file license.txt.  If

- not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,

- Boston, MA 02111-1307, USA.

- */

-

-#ifndef __M_EXTRAICONS_H__

-#define __M_EXTRAICONS_H__

-

-#define MIID_EXTRAICONSSERVICE { 0x62d80749, 0xf169, 0x4592, { 0xb4, 0x4d, 0x3d, 0xd6, 0xde, 0x9d, 0x50, 0xc5 } }

-

-

-#define EXTRAICON_TYPE_CALLBACK 0 	// Similar to old clist callbacks, it fires 2 notifications

-#define EXTRAICON_TYPE_ICOLIB 1 	// This extra icon will use only icons registered with icolib. No callbacks

-									// needed. Just call MS_EXTRAICON_SET_ICON passing the name of the extraicon to set one.

-

-

-typedef struct {

-	int cbSize;

-	int type;						// One of EXTRAICON_TYPE_*

-	const char *name;				// Internal name. More than one plugin can register extra icons with the same name

-									// if both have the same type. In this case, both will be handled as one.

-									// This is usefull for ex for extra status, where icq and jabber can share the same slot.

-									// If the types are different the second one will be denied.

-	const char *description;		// [Translated by plugin] Description to be used in GUI

-	const char *descIcon;			// [Optional] Name of an icon registered with icolib to be used in GUI.

-

-	// If type == EXTRAICON_TYPE_CALLBACK this two must be set

-

-	// Callback to add icons to clist, calling MS_CLIST_EXTRA_ADD_ICON

-	// wParam=lParam=0

-	MIRANDAHOOK RebuildIcons;

-

-	// Callback to set the icon to clist, calling MS_CLIST_EXTRA_SET_ICON or MS_EXTRAICON_SET_ICON

-	// wParam = HANDLE hContact

-	// lParam = int slot

-	MIRANDAHOOK ApplyIcon;

-

-	// Other optional callbacks

-

-	// [Optional] Callback called when extra icon was clicked

-	// wParam = HANDLE hContact

-	// lParam = int slot

-	// param = onClickParam

-	MIRANDAHOOKPARAM OnClick;

-

-	LPARAM onClickParam;

-

-} EXTRAICON_INFO;

-

-

-// Register an extra icon

-// wParam = (EXTRAICON_INFO *) Extra icon info

-// lParam = 0

-// Return: (HANDLE) id of extra icon on success, 0 on error

-#define MS_EXTRAICON_REGISTER "ExtraIcon/Register"

-

-

-typedef struct {

-	int cbSize;

-	HANDLE hExtraIcon;				// Value returned by MS_EXTRAICON_REGISTER

-	HANDLE hContact;				// Contact to set the extra icon

-	union {							// The icon to be set. This depends on the type of the extra icon:

-		HANDLE hImage; 				// Value returned by MS_CLIST_EXTRA_ADD_ICON (if EXTRAICON_TYPE_CALLBACK)

-		const char *icoName;		// Name of the icon registered with icolib (if EXTRAICON_TYPE_ICOLIB)

-	};

-} EXTRAICON;

-

-// Set an extra icon icon

-// wParam = (EXTRAICON *) Extra icon

-// Return: 0 on success

-#define MS_EXTRAICON_SET_ICON "ExtraIcon/SetIcon"

-

-

-

-#ifndef _NO_WRAPPERS

-#ifdef __cplusplus

-

-static HANDLE ExtraIcon_Register(const char *name, const char *description, const char *descIcon,

-								 MIRANDAHOOK RebuildIcons,

-								 MIRANDAHOOK ApplyIcon,

-								 MIRANDAHOOKPARAM OnClick = NULL, LPARAM onClickParam = NULL)

-{

-	if (!ServiceExists(MS_EXTRAICON_REGISTER))

-		return NULL;

-

-	EXTRAICON_INFO ei = {0};

-	ei.cbSize = sizeof(ei);

-	ei.type = EXTRAICON_TYPE_CALLBACK;

-	ei.name = name;

-	ei.description = description;

-	ei.descIcon = descIcon;

-	ei.RebuildIcons = RebuildIcons;

-	ei.ApplyIcon = ApplyIcon;

-	ei.OnClick = OnClick;

-	ei.onClickParam = onClickParam;

-

-	return (HANDLE) CallService(MS_EXTRAICON_REGISTER, (WPARAM) &ei, 0);

-}

-

-static HANDLE ExtraIcon_Register(const char *name, const char *description, const char *descIcon = NULL,

-								 MIRANDAHOOKPARAM OnClick = NULL, LPARAM onClickParam = NULL)

-{

-	if (!ServiceExists(MS_EXTRAICON_REGISTER))

-		return NULL;

-

-	EXTRAICON_INFO ei = {0};

-	ei.cbSize = sizeof(ei);

-	ei.type = EXTRAICON_TYPE_ICOLIB;

-	ei.name = name;

-	ei.description = description;

-	ei.descIcon = descIcon;

-	ei.OnClick = OnClick;

-	ei.onClickParam = onClickParam;

-

-	return (HANDLE) CallService(MS_EXTRAICON_REGISTER, (WPARAM) &ei, 0);

-}

-

-static int ExtraIcon_SetIcon(HANDLE hExtraIcon, HANDLE hContact, HANDLE hImage)

-{

-	EXTRAICON ei = {0};

-	ei.cbSize = sizeof(ei);

-	ei.hExtraIcon = hExtraIcon;

-	ei.hContact = hContact;

-	ei.hImage = hImage;

-

-	return CallService(MS_EXTRAICON_SET_ICON, (WPARAM) &ei, 0);

-}

-

-static int ExtraIcon_SetIcon(HANDLE hExtraIcon, HANDLE hContact, const char *icoName)

-{

-	EXTRAICON ei = {0};

-	ei.cbSize = sizeof(ei);

-	ei.hExtraIcon = hExtraIcon;

-	ei.hContact = hContact;

-	ei.icoName = icoName;

-

-	return CallService(MS_EXTRAICON_SET_ICON, (WPARAM) &ei, 0);

-}

-

-#endif

-#endif

-

-

-#endif // __M_EXTRAICONS_H__

diff --git a/protocols/IcqOscarJ/m_folders.h b/protocols/IcqOscarJ/m_folders.h
deleted file mode 100644
index c681074ed4..0000000000
--- a/protocols/IcqOscarJ/m_folders.h
+++ /dev/null
@@ -1,282 +0,0 @@
-/*

-Custom profile folders plugin for Miranda IM

-

-Copyright © 2005 Cristian Libotean

-

-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_CUSTOM_FOLDERS_H

-#define M_CUSTOM_FOLDERS_H

-

-#define FOLDERS_API 501 //dunno why it's here but it is :)

-

-#define PROFILE_PATH "%profile_path%"

-#define CURRENT_PROFILE "%current_profile%"

-#define MIRANDA_PATH "%miranda_path%"

-#define PLUGINS_PATH "%miranda_path%" "\\plugins"

-

-#define TO_WIDE(x)     L ## x

-

-#define PROFILE_PATHW    L"%profile_path%"

-#define CURRENT_PROFILEW L"%current_profile%"

-#define MIRANDA_PATHW    L"%miranda_path%"

-

-#define FOLDER_AVATARS                 PROFILE_PATH "\\" CURRENT_PROFILE "\\avatars"

-#define FOLDER_VCARDS                  PROFILE_PATH "\\" CURRENT_PROFILE "\\vcards"

-#define FOLDER_LOGS                    PROFILE_PATH "\\" CURRENT_PROFILE "\\logs"

-#define FOLDER_RECEIVED_FILES          PROFILE_PATH "\\" CURRENT_PROFILE "\\received files"

-#define FOLDER_DOCS                    MIRANDA_PATH "\\" "docs"

-

-#define FOLDER_CONFIG                  PLUGINS_PATH "\\" "config"

-

-#define FOLDER_SCRIPTS                 MIRANDA_PATH "\\" "scripts"

-

-#define FOLDER_UPDATES                 MIRANDA_PATH "\\" "updates"

-

-#define FOLDER_CUSTOMIZE               MIRANDA_PATH "\\" "customize"

-#define FOLDER_CUSTOMIZE_SOUNDS        FOLDER_CUSTOMIZE "\\sounds"

-#define FOLDER_CUSTOMIZE_ICONS         FOLDER_CUSTOMIZE "\\icons"

-#define FOLDER_CUSTOMIZE_SMILEYS       FOLDER_CUSTOMIZE "\\smileys"

-#define FOLDER_CUSTOMIZE_SKINS         FOLDER_CUSTOMIZE "\\skins"

-#define FOLDER_CUSTOMIZE_THEMES        FOLDER_CUSTOMIZE "\\themes"

-

-

-#define FOLDERS_NAME_MAX_SIZE 64  //maximum name and section size

-

-#define FF_UNICODE 0x00000001

-

-#if defined (UNICODE)

-	#define FF_TCHAR	FF_UNICODE

-#else

-	#define FF_TCHAR	0

-#endif

-

-typedef struct{

-  int cbSize;                                  //size of struct

-  char szSection[FOLDERS_NAME_MAX_SIZE];       //section name, if it doesn't exist it will be created otherwise it will just add this entry to it

-  char szName[FOLDERS_NAME_MAX_SIZE];          //entry name - will be shown in options

-  union{

-    const char *szFormat;                      //default string format. Fallback string in case there's no entry in the database for this folder. This should be the initial value for the path, users will be able to change it later.

-    const wchar_t *szFormatW;                  //String is dup()'d so you can free it later. If you set the unicode string don't forget to set the flag accordingly.

-    const TCHAR *szFormatT;

-  };

-  DWORD flags;                                 //FF_* flags

-} FOLDERSDATA;

-

-/*Folders/Register/Path service

-  wParam - not used, must be 0

-  lParam - (LPARAM) (const FOLDERDATA *) - Data structure filled with 

-  the necessary information.

-  Returns a handle to the registered path or 0 on error. 

-  You need to use this to call the other services.

-*/

-#define MS_FOLDERS_REGISTER_PATH "Folders/Register/Path"

-

-/*Folders/Get/PathSize service

-  wParam - (WPARAM) (int) - handle to registered path

-  lParam - (LPARAM) (int *) - pointer to the variable that receives the size of the path 

-  string (not including the null character). Depending on the flags set when creating the path

-  it will either call strlen() or wcslen() to get the length of the string.

-  Returns the size of the buffer.

-*/

-#define MS_FOLDERS_GET_SIZE "Folders/Get/PathSize"

-

-typedef struct{

-	int cbSize;

-	int nMaxPathSize;                     //maximum size of buffer. This represents the number of characters that can be copied to it (so for unicode strings you don't send the number of bytes but the length of the string).

-	union{

-		char *szPath;                     //pointer to the buffer that receives the path without the last "\\"

-		wchar_t *szPathW;                 //unicode version of the buffer.

-		TCHAR *szPathT;

-	};

-} FOLDERSGETDATA;

-

-/*Folders/Get/Path service

-  wParam - (WPARAM) (int) - handle to registered path

-  lParam - (LPARAM) (FOLDERSGETDATA *) pointer to a FOLDERSGETDATA that has all the relevant fields filled.

-  Should return 0 on success, or nonzero otherwise.

-*/

-#define MS_FOLDERS_GET_PATH "Folders/Get/Path"

-

-typedef struct{

-  int cbSize;

-  union{

-    char **szPath;                    //address of a string variable (char *) or (wchar_t*) where the path should be stored (the last \ won't be copied).

-    wchar_t **szPathW;                //unicode version of string.

-    TCHAR **szPathT;

-	};

-} FOLDERSGETALLOCDATA;

-

-/*Folders/GetRelativePath/Alloc service

-  wParam - (WPARAM) (int) - Handle to registered path

-  lParam - (LPARAM) (FOLDERSALLOCDATA *) data

-  This service is the same as MS_FOLDERS_GET_PATH with the difference that this service

-  allocates the needed space for the buffer. It uses miranda's memory functions for that and you need

-  to use those to free the resulting buffer.

-  Should return 0 on success, or nonzero otherwise. Currently it only returns 0.

-*/

-#define MS_FOLDERS_GET_PATH_ALLOC "Folders/Get/Path/Alloc"

-

-

-/*Folders/On/Path/Changed

-	wParam - (WPARAM) 0

-	lParam - (LPARAM) 0

-	Triggered when the folders change, you should reget the paths you registered.

-*/

-#define ME_FOLDERS_PATH_CHANGED "Folders/On/Path/Changed"

-

-#ifndef FOLDERS_NO_HELPER_FUNCTIONS

-

-#ifndef M_UTILS_H__

-#error The helper functions require that m_utils.h be included in the project. Please include that file if you want to use the helper functions. If you don''t want to use the functions just define FOLDERS_NO_HELPER_FUNCTIONS.

-#endif

-//#include "../../../include/newpluginapi.h"

-

-__inline static HANDLE FoldersRegisterCustomPath(const char *section, const char *name, const char *defaultPath)

-{

-	FOLDERSDATA fd = {0};

-	if (!ServiceExists(MS_FOLDERS_REGISTER_PATH)) return 0;

-	fd.cbSize = sizeof(FOLDERSDATA);

-	strncpy(fd.szSection, section, FOLDERS_NAME_MAX_SIZE);

-	fd.szSection[FOLDERS_NAME_MAX_SIZE - 1] = '\0';

-	strncpy(fd.szName, name, FOLDERS_NAME_MAX_SIZE);

-	fd.szName[FOLDERS_NAME_MAX_SIZE - 1] = '\0';

-	fd.szFormat = defaultPath;

-	return (HANDLE) CallService(MS_FOLDERS_REGISTER_PATH, 0, (LPARAM) &fd);

-}

-

-__inline static HANDLE FoldersRegisterCustomPathW(const char *section, const char *name, const wchar_t *defaultPathW)

-{

-	FOLDERSDATA fd = {0};

-	if (!ServiceExists(MS_FOLDERS_REGISTER_PATH)) return 0;

-	fd.cbSize = sizeof(FOLDERSDATA);

-	strncpy(fd.szSection, section, FOLDERS_NAME_MAX_SIZE);

-	fd.szSection[FOLDERS_NAME_MAX_SIZE - 1] = '\0'; //make sure it's NULL terminated

-	strncpy(fd.szName, name, FOLDERS_NAME_MAX_SIZE);

-	fd.szName[FOLDERS_NAME_MAX_SIZE - 1] = '\0'; //make sure it's NULL terminated

-	fd.szFormatW = defaultPathW;

-	fd.flags = FF_UNICODE;

-	return (HANDLE) CallService(MS_FOLDERS_REGISTER_PATH, 0, (LPARAM) &fd);

-}

-

-__inline static INT_PTR FoldersGetCustomPath(HANDLE hFolderEntry, char *path, const int size, const char *notFound)

-{

-	FOLDERSGETDATA fgd = {0};

-	INT_PTR res;

-	fgd.cbSize = sizeof(FOLDERSGETDATA);

-	fgd.nMaxPathSize = size;

-	fgd.szPath = path;

-	res = CallService(MS_FOLDERS_GET_PATH, (WPARAM) hFolderEntry, (LPARAM) &fgd);

-	if (res)

-	{

-		char buffer[MAX_PATH];

-		CallService(MS_UTILS_PATHTOABSOLUTE, (WPARAM) notFound, (LPARAM) buffer);

-		mir_snprintf(path, size, "%s", buffer);

-	}

-		

-	return res;

-}

-

-__inline static INT_PTR FoldersGetCustomPathW(HANDLE hFolderEntry, wchar_t *pathW, const int count, const wchar_t *notFoundW)

-{

-	FOLDERSGETDATA fgd = {0};

-	INT_PTR res;

-	fgd.cbSize = sizeof(FOLDERSGETDATA);

-	fgd.nMaxPathSize = count;

-	fgd.szPathW = pathW;

-	res = CallService(MS_FOLDERS_GET_PATH, (WPARAM) hFolderEntry, (LPARAM) &fgd);

-	if (res)

-	{

-		wcsncpy(pathW, notFoundW, count);

-		pathW[count - 1] = '\0';

-	}

-		

-	return res;

-}

-

-__inline static INT_PTR FoldersGetCustomPathEx(HANDLE hFolderEntry, char *path, const int size, char *notFound, char *fileName)

-{

-	FOLDERSGETDATA fgd = {0};

-	INT_PTR res;

-	fgd.cbSize = sizeof(FOLDERSGETDATA);

-	fgd.nMaxPathSize = size;

-	fgd.szPath = path;

-	res = CallService(MS_FOLDERS_GET_PATH, (WPARAM) hFolderEntry, (LPARAM) &fgd);

-	if (res)

-	{

-		char buffer[MAX_PATH];

-		CallService(MS_UTILS_PATHTOABSOLUTE, (WPARAM) notFound, (LPARAM) buffer);

-		mir_snprintf(path, size, "%s", buffer);

-	}

-	if (strlen(path) > 0)

-	{

-		strcat(path, "\\");

-	}

-	else{

-		path[0] = '\0';

-	}

-	

-	if (fileName)

-	{

-		strcat(path, fileName);

-	}

-	

-	return res;

-}

-

-__inline static INT_PTR FoldersGetCustomPathExW(HANDLE hFolderEntry, wchar_t *pathW, const int count, wchar_t *notFoundW, wchar_t *fileNameW)

-{

-	FOLDERSGETDATA fgd = {0};

-	INT_PTR res;

-	fgd.cbSize = sizeof(FOLDERSGETDATA);

-	fgd.nMaxPathSize = count;

-	fgd.szPathW = pathW;

-	res = CallService(MS_FOLDERS_GET_PATH, (WPARAM) hFolderEntry, (LPARAM) &fgd);

-	if (res)

-	{

-		wcsncpy(pathW, notFoundW, count);

-		pathW[count - 1] = '\0';

-	}

-	

-	if (wcslen(pathW) > 0)

-	{

-		wcscat(pathW, L"\\");

-	}

-	else{

-		pathW[0] = L'\0';

-	}

-	

-	if (fileNameW)

-	{

-		wcscat(pathW, fileNameW);

-	}

-	

-	return res;

-}

-

-# ifdef _UNICODE

-#  define FoldersGetCustomPathT FoldersGetCustomPathW

-#  define FoldersGetCustomPathExT FoldersGetCustomPathExW

-#  define FoldersRegisterCustomPathT FoldersRegisterCustomPathW

-#else

-#  define FoldersGetCustomPathT FoldersGetCustomPath

-#  define FoldersGetCustomPathExT FoldersGetCustomPath

-#  define FoldersRegisterCustomPathT FoldersRegisterCustomPath

-#endif

-

-#endif

-

-#endif //M_CUSTOM_FOLDERS_H

diff --git a/protocols/IcqOscarJ/m_updater.h b/protocols/IcqOscarJ/m_updater.h
deleted file mode 100644
index c83b8a4600..0000000000
--- a/protocols/IcqOscarJ/m_updater.h
+++ /dev/null
@@ -1,117 +0,0 @@
-#ifndef _M_UPDATER_H

-#define _M_UPDATER_H

-

-// if you set Update::szUpdateURL to the following value when registering, as well as setting your beta site and version data,

-// updater will ignore szVersionURL and pbVersionPrefix, and attempt to find the file listing URL's from the backend XML data.

-// for this to work, the plugin name in pluginInfo.shortName must match the file listing exactly (except for case)

-#define UPDATER_AUTOREGISTER		"UpdaterAUTOREGISTER"

-

-typedef struct Update_tag {

-  int cbSize;     

-  char *szComponentName;		// component name as it will appear in the UI (will be translated before displaying)

-

-  char *szVersionURL;			// URL where the current version can be found (NULL to disable)

-  BYTE *pbVersionPrefix;		// bytes occuring in VersionURL before the version, used to locate the version information within the URL data

-								// (not that this URL could point at a binary file - dunno why, but it could :)

-  int cpbVersionPrefix;			// number of bytes pionted to by pbVersionPrefix

-  char *szUpdateURL;			// URL where dll/zip is located

-								// set to UPDATER_AUTOREGISTER if you want updater to find the file listing URLs (ensure plugin shortName matches file listing!)

-

-  char *szBetaVersionURL;		// URL where the beta version can be found (NULL to disable betas)

-  BYTE *pbBetaVersionPrefix;	// bytes occuring in VersionURL before the version, used to locate the version information within the URL data

-  int cpbBetaVersionPrefix;		// number of bytes pionted to by pbVersionPrefix

-  char *szBetaUpdateURL;		// URL where dll/zip is located

-

-  BYTE *pbVersion;				// bytes of current version, used for comparison with those in VersionURL

-  int cpbVersion;				// number of bytes pionted to by pbVersion

-

-  char *szBetaChangelogURL;		// url for displaying changelog for beta versions

-} Update;

-

-// register a comonent with the updater

-//

-// wparam = 0

-// lparam = (LPARAM)&Update

-#define MS_UPDATE_REGISTER      "Update/Register"

-

-// utility functions to create a version string from a DWORD or from pluginInfo

-// point buf at a buffer at least 16 chars wide - but note the version string returned may be shorter

-//

-__inline static char *CreateVersionString(DWORD version, char *buf) {

-	mir_snprintf(buf, 16, "%d.%d.%d.%d", (version >> 24) & 0xFF, (version >> 16) & 0xFF, (version >> 8) & 0xFF, version & 0xFF);

-	return buf;

-}

-

-__inline static char *CreateVersionStringPlugin(PLUGININFO *pluginInfo, char *buf) {

-	return CreateVersionString(pluginInfo->version, buf);

-}

-

-

-// register the 'easy' way - use this method if you have no beta URL and the plugin is on the miranda file listing

-// NOTE: the plugin 'short name' in pluginInfo must match the name of the plugin on the file listing, exactly (not including case)

-// AND the plugin version string on the file listing must be the string version of the version in pluginInfo (i.e. 0.0.0.1,

-// so no letters, brackets, etc.)

-//

-// wParam = (int)fileID				- this is the file ID from the file listing (i.e. the number at the end of the download link)

-// lParam = (PLUGININFO*)&pluginInfo

-#define MS_UPDATE_REGISTERFL	"Update/RegisterFL"

-

-// this event is fired when the startup process is complete, but NOT if a restart is imminent

-// it is designed for status managment plugins to use as a trigger for beggining their own startup process

-// wParam = lParam = 0 (unused)

-// (added in version 0.1.6.0)

-#define ME_UPDATE_STARTUPDONE	"Update/StartupDone"

-

-// this service can be used to enable/disable Updater's global status control

-// it can be called from the StartupDone event handler

-// wParam = (BOOL)enable

-// lParam = 0

-// (added in version 0.1.6.0)

-#define MS_UPDATE_ENABLESTATUSCONTROL	"Update/EnableStatusControl"

-

-// An description of usage of the above service and event:

-// Say you are a status control plugin that normally sets protocol or global statuses in your ModulesLoaded event handler.

-// In order to make yourself 'updater compatible', you would move the status control code from ModulesLoaded to another function, 

-// say DoStartup. Then, in ModulesLoaded you would check for the existence of the MS_UPDATE_ENABLESTATUSCONTROL service.

-// If it does not exist, call DoStartup. If it does exist, hook the ME_UPDATE_STARTUPDONE event and call DoStartup from there. You may

-// also wish to call MS_UPDATE_ENABLESTATUSCONTROL with wParam == FALSE at this time, to disable Updater's own status control feature.

-

-#endif

-

-

-/////////////// Usage Example ///////////////

-

-#ifdef EXAMPLE_CODE

-

-// you need to #include "m_updater.h" and HookEvent(ME_SYSTEM_MODULESLOADED, OnModulesLoaded) in your Load function...

-

-int OnModulesLoaded(WPARAM wParam, LPARAM lParam) {

-

-	Update update = {0}; // for c you'd use memset or ZeroMemory...

-	char szVersion[16];

-

-	update.cbSize = sizeof(Update);

-

-	update.szComponentName = pluginInfo.shortName;

-	update.pbVersion = (BYTE *)CreateVersionString(&pluginInfo, szVersion);

-	update.cpbVersion = strlen((char *)update.pbVersion);

-

-	// these are the three lines that matter - the archive, the page containing the version string, and the text (or data) 

-	// before the version that we use to locate it on the page

-	// (note that if the update URL and the version URL point to standard file listing entries, the backend xml

-	// data will be used to check for updates rather than the actual web page - this is not true for beta urls)

-	update.szUpdateURL = "http://scottellis.com.au:81/test/updater.zip";

-	update.szVersionURL = "http://scottellis.com.au:81/test/updater_test.html";

-	update.pbVersionPrefix = (BYTE *)"Updater version ";

-	

-	update.cpbVersionPrefix = strlen((char *)update.pbVersionPrefix);

-

-	CallService(MS_UPDATE_REGISTER, 0, (WPARAM)&update);

-

-	// Alternatively, to register a plugin with e.g. file ID 2254 on the file listing...

-	// CallService(MS_UPDATE_REGISTERFL, (WPARAM)2254, (LPARAM)&pluginInfo);

-

-	return 0;

-}

-

-#endif