mail::ACCOUNT::login — Open a new mail account
        
        
        #include <libmail/sync.H>
        
        mail::ACCOUNT *mail=new mail::ACCOUNT;
        
        mail::account::openInfo accountOpenInfo;
        
| bool
            ok=mail->login( | accountOpenInfo ); | 
        std::string errmsg=mail->getErrmsg();
mail::ACCOUNT::login opens a
      new mail account. The mail account's location is specified by
      accountOpenInfo. See
      mail::account::open(3x) for
      the description of the parameters set by accountOpenInfo.
This method returns true if
      it succeeds, or false if it
      fails. If the method fails, use mail::ACCOUNT::getErrmsg() to
      read a brief description of the error.
The object must be destroyed if mail::ACCOUNT::login fails. A new
        mail::ACCOUNT object must
        be created for another login attempt.