Message status manipulation functions

• mail_setflag

  void mail_setflag(MAILSTREAM *stream, char *sequence, char *flag);
  
  void mail_setflag_full(MAILSTREAM *stream, char *sequence, char *flag,
       long flags);
  

  
  stream

  Stream to use.

  
  sequence

  IMAP-format set of message sequence numbers.

  
  flag

  IMAP-format flag string.

  
  flags

  Option flags.

  These functions cause a store to add the specified flag to the flags set for the messages in the specified sequence. If there is any problem in setting flags, a message will be passed to the application via the mm_log facility.

  The options for mail_setflag_full are a bit mask with one or more of the following:

  
  ST_UID

  The sequence argument contains UIDs instead of sequence numbers.

  
  ST_SILENT

  Do not update the local cache with the new value of the flags; this is useful to save network bandwidth, at the cost of invalidating the cache.

• mail_clearflag

  void mail_clearflag(MAILSTREAM *stream, char *sequence, char *flag);
  
  void mail_clearflag_full(MAILSTREAM *stream, char *sequence, char *flag,
       long flags);
  

  
  stream

  Stream to use.

  
  sequence

  IMAP-format set of message sequence numbers.

  
  flag

  IMAP-format flag string.

  
  flags

  Option flags.

  These functions cause a store to delete the specified flag from the flags set for the messages in the specified sequence. If there is any problem in clearing flags, a message will be passed to the application via the mm_log facility.

  The options for mail_setflag_full are a bit mask with one or more of the following:

  
  ST_UID

  The sequence argument contains UIDs instead of sequence numbers.

  
  ST_SILENT

  Do not update the local cache with the new value of the flags; this is useful to save network bandwidth, at the cost of invalidating the cache.