Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Conversation.InviteContact Method (Contact)

Invites the contact to the conversation.

Script:  http://www.wlmessenger.net/api/3.7/loader.js
Feature:  Messenger.Core
Namespace:  Microsoft.Live.Messenger
 
instance.inviteContact(contact);

Parameters

contact
Type: Microsoft.Live.Messenger.Contact
The contact being invited to the conversation.

This method attempts to invite a contact to the conversation. If a user is having a conversation with another contact, both the user and the other contact can invite additional participants to the conversation.

This method is equivalent to providing the CurrentAddress of a Contact to the InviteAddress(IMAddress) method.

When the invite operation completes, the InviteAddressCompleted event is raised. This event should be handled to determine whether the contact was successfully invited to the conversation. An invitation can fail if the other contact went offline while the invite was in transit or if the invited contact doesn't support multiparty chat.

Once an invited contact joins a conversation, the CollectionChanged event is raised on the Roster property. This event should be handled to detect changes in the conversation's roster.

ExceptionCondition
Exceptioncontact is a null reference.
Exceptioncontact has already been invited to the conversation.
ExceptionThe conversation does not support multiparty chat.
ExceptionThe user is not signed in.

Windows Live Messenger Web Toolkit

Supported in: 3.7, 3.5, 3.1, 3.0

Internet Explorer 8.0, Internet Explorer 7.0, Internet Explorer 6.0, Firefox 3.5, Firefox 3.0, Firefox 2.0, Firefox 1.5, Chrome 3.0, Chrome 2.0, Chrome 1.0, Safari 4.0, Safari 3.0

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.