#ifndef __M_YAMN_H #define __M_YAMN_H #include // //================================== VARIABLES STRUCT ======================================== // typedef struct CYAMNVariables { #define YAMN_VARIABLESVERSION 3 MWindowList MessageWnds; MWindowList NewMailAccountWnd; int Shutdown; } YAMN_VARIABLES, *PYAMN_VARIABLES; // //================================== EXPORTED FUNCTIONS STRUCT =============================== // struct CExportedFunctions { char* ID; void *Ptr; }; struct CExportedServices { char* ID; INT_PTR (* Ptr)(WPARAM,LPARAM); }; // //================================== YAMN EVENTS ================================== // //UninstallPlugin Event //Sent when user wants to uninstall YAMN and all its plugins #define ME_YAMN_UNINSTALLPLUGINS "YAMN/MirandaEvents/UninstallPlugins" //NewMail Event //Notifies you about new mail //no arguments now (Developers, send mail, which params would you like to have, but note there's problem that //params are 32b numbers. When it is pointer to some data, these data should persist while every plugin read them and //after that they can be removed from memory. So it is problem) #define ME_YAMN_NEWMAIL "YAMN/MirandaEvents/NewMail" // //================================== YAMN SERVICES ================================== // //GetFcnPtr Service //Your plugin can co-operate with YAMN in 2 ways: with Miranda services and with YAMN exported functions //Some commands are written in services, some are functions. The advantage of function calling instead of //service calling is, that your code is more clear and it is faster than service calling (smaller, FASTER, //easier- it is slogan of Miranda, isn't it ?). Miranda service has only 2 parameters, that can be //disadvantage too. //In every way, it is discutable which functions should be exported or if they should be implemented as //services. And if YAMN should export some functions etc. Functions not used very often are now implemented //as Miranda services. // //This service gets pointer to YAMN function. Then you can use function directly. In m_?????.h files you have //definitions of some functions, with definitions of structure variable, so you can use functions very //clearly, just look to header file. //WPARAM- function ID. It is string representating function you need to get pointer (e.g. YAMN_WRITEWAITID) //LPARAM- not used now, but set it to 0 //returns pointer to YAMN function or NULL when functions does not exist #define MS_YAMN_GETFCNPTR "YAMN/Service/GetFcn" //GetVariables Service //Ask YAMN for pointer to CYAMNVariables structure. //WPARAM- YAMN_VARIABLESVERSION //LPARAM- any value //returns pointer to YAMN_VARIABLES or NULL when version of structure does not match #define MS_YAMN_GETVARIABLES "YAMN/Service/GetVar" //ForceCheck Service //Check mail on accounts //WPARAM- not used //LPARAM- not used #define MS_YAMN_FORCECHECK "YAMN/Service/ForceCheck" //AccountCheck Service //Check mail on individual account //WPARAM- HACCOUNT //LPARAM- BOOL: Show Popup on no new mail #define MS_YAMN_ACCOUNTCHECK "YAMN/Service/AccountCheck" //Contact List Context Menu Click //wParam=(WPARAM)hContact //lParam=0 // //Event is fired when there is a double click on a CList contact, //it is upto the caller to check for the protocol & status //of the MCONTACT, it's not done for you anymore since it didn't make //sense to store all this information in memory, etc. #define MS_YAMN_CLISTCONTEXT "YAMN/Service/ClistContactContextMenu" //Contact List Context Menu Click for application //wParam=(WPARAM)hContact //lParam=0 // //Event is fired when there is a double click on a CList contact, //it is upto the caller to check for the protocol & status //of the MCONTACT, it's not done for you anymore since it didn't make //sense to store all this information in memory, etc. #define MS_YAMN_CLISTCONTEXTAPP "YAMN/Service/ClistContactContextMenuApp" //Contact List Double Click //wParam=(WPARAM)hContact //lParam=0 // //Event is fired when there is a double click on a CList contact, //it is upto the caller to check for the protocol & status //of the MCONTACT, it's not done for you anymore since it didn't make //sense to store all this information in memory, etc. #define MS_YAMN_CLISTDBLCLICK "YAMN/Service/ClistContactDoubleclicked" //FilterMail Service //Ask YAMN to process mail filtering. YAMN calls filter plugins to mark mail as spam etc... Warning! Leave all //read or write access to mail as this function waits for write-access to mail! //WPARAM- (HACCOUNT) account to which mail belongs //LPARAM- (HYAMNMAIL) mail to filter #define MS_YAMN_FILTERMAIL "YAMN/Service/FilterMail" //MailBrowser Service //runs mail browser window (or tray icon only or popups only) //WPARAM- pointer to YAMN_MAILBROWSERPARAM structure, data to mailbrowser. You do not need to fill ThreadRunningEV event member. //LPARAM- YAMN_MAILBROWSERPARAM structure version param. Use YAMN_MAILBROWSERVERSION definition. //returns zero if failed, nonzero if succeed #define MS_YAMN_MAILBROWSER "YAMN/Service/RunMailBrowser" //NoNewMail Service //runs no new mail procedure (shows popups e.g.) //WPARAM- pointer to YAMN_NONEWMAILPARAM structure, data to no new mail procedure. You do not need to fill ThreadRunningEV event member. //LPARAM- YAMN_NONEWMAILPARAM structure version param. Use YAMN_NONEWMAILVERSION definition. //returns zero if failed, nonzero if succeed #define MS_YAMN_NONEWMAILPROC "YAMN/Service/NoNewMailProc" #endif