IMailMsgRecipients::AllocNewList

[This is preliminary documentation and subject to change.]

Create a new recipient list.

HRESULT AllocNewList( [out] IMailMsgRecipientsAdd **ppNewList);

ppNewList

A reference to an object that can be used to create the new list.

Return Values

Remarks

When allocating a new list of recipients for the object, you use a separate object exposing the IMailMsgRecipientsAdd interface. When first returned, the object has no recipients in memory.

After updating the recipient list in this separate object, you update the MailMsg object using the IMailMsgRecipients::WriteList method. To commit the changes to physical storage, invoke the IMailMsgRecipients::Commit method.

See Also

IMailMsgRecipients::WriteList

IMailMsgRecipientsAdd Interface