DistListItem.RemoveMember Method (Outlook)

Removes an individual member from a given distribution list.

Syntax

expression. RemoveMember( _Recipient_ )

expression A variable that represents a DistListItem object.

Parameters

Name Required/Optional Data Type Description
Recipient Required Recipient The Recipient to be removed from the distribution list.

Example

The following Microsoft Visual Basic for Applications (VBA) example removes a member from the distribution list called Group List. The RemoveMember method will fail if the specified recipient is not valid. Before running the example, create or make sure a distribution list called 'Group List' exists in your default Contacts folder.

Sub RemoveRec() 
 
 'Remove a recipient from the list, and displays new list. 
 
 
 
 Dim objDstList As Outlook.DistListItem 
 
 Dim objName As Outlook.NameSpace 
 
 Dim objRcpnt As Outlook.Recipient 
 
 Dim objMail As Outlook.MailItem 
 
 
 
 Set objName = Application.GetNamespace("MAPI") 
 
 Set objDstList = objName.GetDefaultFolder(olFolderContacts).Items("Group List") 
 
 Set objMail = Application.CreateItem(olMailItem) 
 
 Set objRcpnt = objMail.Recipients.Add(Name:="someone@example.com") 
 
 objRcpnt.Resolve 
 
 objDstList.RemoveMember Recipient:=objRcpnt 
 
 objDstList.Display 
 
 objDstList.Body = "Last Modified: " & Now 
 
End Sub

See also

DistListItem Object