RDODistListItem object

set Session = CreateObject("Redemption.RDOSession")
Session.Logon
set Contacts = Session.GetDefaultFolder(olFolderContacts)
set DL = Contacts.Items.Add("IPM.DistList")
DL.DLName = "Redemption test"
DL.AddMember("test <test@dimastr.com>")
DL.Save

Derived from: RDOMail

Properties

CheckSum

integer, internal use only. CheckSum property represents the checksum unique to the given list of the DL members.

DLName

Returns or sets a String representing the display name of a distribution list. Read/write.

see the example at the top of this page

MemberCount

Returns an integer indicating the number of members in a distribution list. Read-only.

Members

Returns an RDOAddressEntries object representing the members of the distribution list.

Distribution lists store members in two collections: Members, which contains the original entry ids,  and OneOffMembers, which contains the one-off entry ids. One-off entry ids are self contained, i.e. they embed both the name and address of the address entry. If a member points to a contact that was deleted, it would be impossible to retrieve the member, while the one-off entry id will still be valid since it does not depend on any external MAPI objects.

GetMember method (see below) checks if the member entry id is still valid. If not, it returns an RDOAddressEntry object corresponding to the one-off entry id.

set Session = CreateObject("Redemption.RDOSession")
Session.MAPIOBJECT = Application.Session.MAPIOBJECT
set Contacts = Session.GetDefaultFolder(olFolderContacts)
set DL = Contacts.Items("test dl")
for each Member in DL.Members
  Debug.Print Member.Name & ": " & Member.Address
next

OneOffMembers

Returns an RDOAddressEntries object representing the members of the distribution list.

See comment for the Members property above.

Methods

AddContact(ContactItem, AddressType)

Adds a Contact or a Distribution List as a member of the distribution list.

ContactItem - an object representing IPM.Contact or IPM.DistList message, such as RDOContactItem, RDODistList, RDOMail, Outlook.MailItem, etc object. The only requirement is that the object must expose a MAPIOBJECT property which returns an IMessage Extended MAPI object.
AddressType - one of the rdoAddressType enums that specify which contact address (Email1, Emal2, Fax1, etc) must be added.

This parameter is ignored if a Distribution List is being added.

rdoAddressType values:
atEmail1 = 0
atEmail2 = 1
atEmail3 = 2
atBusinessFax = 3
atHomeFax = 4
atOtherFax = 5

set Session = CreateObject("Redemption.RDOSession")
Session.MAPIOBJECT = Application.Session.MAPIOBJECT
set Contacts = Session.GetDefaultFolder(olFolderContacts)

'retrieve an existing distribution list
set DL = Contacts.Items("test dl")

'retrieve an existing contact's Email3 address to the DL
set Contact = Contacts.Items("Dmitry Streblechenko")
'add the contact to thee distribution list and save it
DL.AddContact(Contact, atEmail3)
DL.Save

AddMemberEx(Name, Address, AddressType)

Allows to add a one-off address to the distribution list

Name - string, the name of the member

Address- string, the address of the member

AddressType- string, the address type of the member, e.g. "SMTP"

DistListItem.AddMemberEx("Dmitry", "test@dimastr.com", "SMTP")

AddMember(RecipientOrAddressentryOrName)

Adds a given object as a member of the distribution list.

RecipientOrAddressentryOrName - RDORecipient, RDOAddressEntry or a string representing the new member. If the value is a string, it will be resolved to an address entry using the standard name resolution.

see the example at the top of this page

AddMembers(Recipients)

Adds all of the recipients to the distribution list.

Recipients - RDORecipients object, most often returned by the RDOMail.Recipients property

GetMember(Index)

Returns an RDOAddressEntry object representing the member with the given index. This method checks if the member entry id is still valid and returns an entry from the Members collection. If not, it returns an RDOAddressEntry object corresponding to the one-off entry id from the OneOffMembers collection. See Members property help above.

Index - integer, 1 through MemberCount.

RemoveMember(Index)

Removes the distribution list member with the given index.

Index - integer, 1 through MemberCount.