| Programming Guide | |
Returns the object ID of a new email message
int sm_mail_new(char *name);
name- An optional name to be assigned to the mail object that is to be created.
sm_mail_newreturns the object ID of a new message. Ifnameis supplied, it can be used to set properties of the message. Before the message is sent, the following properties can be set:
PR_MAIL_SUBJECT- Text of the
Subject:line.PR_MAIL_TEXT- Text of the message. There are several functions that also can be used to set the message text.
PR_MAIL_FROM- Information for the
From:line of mail messages. Some Mail Transfer Agents ignore this property.PR_MAIL_TO- Information for the
To:line of mail messages.PR_MAIL_CC- Information for the
CC:line of mail messages.PR_MAIL_BCC- Information for the
BCC:line of mail messages.PR_MAIL_REPLYTO- Information for the
Reply-to:line of mail messages. Ignored when using MAPI.PR_MAIL_RECEIPT- Whether to ask for a receipt when the mail is first read. This seemingly does not work for most Mail Transfer Agents (Outlook and Outlook Express in particular).
PR_NAME- Name of the message.
sm_*mail_send, sm_*mail_attach
1 Integer handle to the new mail object.