Sender Property (Message Object)
Topic Last Modified: 2004-06-09
The Sender property returns or sets the sender of a message as an AddressEntry object. Read/write.
Set objAddrEntry = objMessage.Sender
Object. The returned AddressEntry object that represents the messaging user that sent the message.
Object. The Message object.
You can change the Sender property before a message is either sent or saved, for example in a public folder. After a message has been sent or saved, any attempt to change its Sender property is ignored.
You can use the Sender property to send or post a message from one messaging user on behalf of another messaging user. When you set Sender to a messaging user, CDO identifies that user as both the sender of the message and the user on whose behalf the message is being sent or posted. If you then set Sender to a second messaging user, the message is identified as being sent or posted by the second messaging user on behalf of the first:
Dim objMsg As MAPI.Message ' message to be sent/posted; assume valid Dim objMyself As MAPI.AddressEntry ' I will send/post the message ... Dim objMyBoss As MAPI.AddressEntry ' ... on behalf of my boss ' ... Set objMyself = objSession.CurrentUser ' AE object for myself Set objMyBoss = objMyself.Manager ' my boss; assume valid With objMsg Set Sender = objMyBoss ' sets represented sender properties Set Sender = objMyself ' leaves represented sender properties alone .Subject = "I am sending/posting this on behalf of my manager" End With
For more information, see "Sender Properties" and "Represented Sender Properties" in the MAPI Programmers Reference.
The Sender property is not exposed on AppointmentItem objects created by Microsoft® Schedule+, and it is not automatically set when you create an appointment within a CDO application. In these cases, the application must assign a value to Sender or an attempt to read it returns CdoE_NOT_FOUND.
The Sender property does not correspond to a MAPI property and cannot be rendered into HTML hypertext by the CDO Rendering Library. It could be rendered as an object by setting the ObjectRenderer object's DataSource property to the AddressEntry object returned by the Sender property.
The Name property of the AddressEntry object returned by the Sender property corresponds to the MAPI property PR_SENT_REPRESENTING_NAME. To render just the sender's name, you can set the object renderer's DataSource property to this AddressEntry object and the property parameter of the RenderProperty method to CdoPR_SENT_REPRESENTING_NAME.
This code fragment displays the name of the sender of a message:
' from the sample function Message_Sender Set objAddrEntry = objOneMsg.Sender If objAddrEntry Is Nothing Then MsgBox "Could not set the AddressEntry object from the Sender" Exit Function End If MsgBox "Message was sent by " & objAddrEntry.Name