diff -r 6b8f3b30d0ec -r efd4f1afd43e emailservices/emailframework/inc/CFSMailClient.h --- a/emailservices/emailframework/inc/CFSMailClient.h Wed Jun 09 09:22:57 2010 +0300 +++ b/emailservices/emailframework/inc/CFSMailClient.h Mon Jun 21 15:20:54 2010 +0300 @@ -212,10 +212,27 @@ * returns email mailbox object related to given mailbox id * * @param aMailBoxId mailbox id - * @return mailbox object ( CFSMailBox ), ownership is transferred to user + * @return mailbox object ( CFSMailBox ) + * or NULL if no matching mailbox found. + * Ownership is transferred to user! */ IMPORT_C CFSMailBox* GetMailBoxByUidL( const TFSMailMsgId aMailBoxId); - + + + /** + * returns email mailbox object related to given mailbox id. Otherwise + * identical to GetMailBoxByUidL but mailbox object is stored to cleanup + * stack. + * + * @param aMailBoxId mailbox id + * @return mailbox object ( CFSMailBox ) + * or NULL if no matching mailbox found. + * CFSMailBox pointer is stored to cleanup stack (even if NULL). + * Ownership is transferred to user! + */ + IMPORT_C CFSMailBox* GetMailBoxByUidLC( const TFSMailMsgId aMailBoxId); + + /** * returns email folder object related to given folder id *