Groupwise Developer's Guide

80
Deleting or Retracting a Message
Use the Delete() method on a Message object subtype to delete a Mail,
Appointment, or Task.
MessageSubtype.Delete()
This method requires no parameters. Delete() moves a message from its
associated folder(s) to the trash. This can be somewhat confusing when deleting
messages from a shared folder as the message is placed in the owner's trash and
not necessarily into the trash of the account that made the delete call.
Use the Retract() method on a Message object subtype to retract a Mail,
Appointment, or Task.
MessageSubtype.Retract()
This method requires no parameters. Retract() will delete a message from a
recipient's mailbox provided that the message's BoxType is egwOutgoing, the
message has not been opened and has not gone through a gateway to another mail
system.
MessageSubtype.Annotate(Note as Note)
This method adds an existing personal Note object as an attachment to this
message. Works even if this message has been sent, because the Note is personal.
See also the Add method in the Attachment object. Annotating an item requires
create and modify rights to the folder that contains the item. Annotating
encapsulated items is not allowed because no distinct containing folders exist for
such an item. Annotations can be edited only by the user who originally created
the annotation (subject also to folder rights). For example, an annotation created
on an item in a shared folder can only be edited by the user who created the
annotation.
The Different Types of Message
GroupWise supports six main subtypes of the Message object. In fact, because the
Message object is never itself created, one of the objects described below will
always be used where a message object is required. Message subtypes include:
Mail (standard “e-mail” messages), Appointments, DocumentReferences, Notes,
Phone Messages, and Tasks. In addition to the properties and methods that each
object inherits from the GroupWise Message object, a Message subtype may also
have its own special properties and possibly methods. For received messages, you
can read these properties, and you can read or write them for draft messages.
www.novell.com/appnotes