Share via

IMessengerConversationWnd::AddContact Method

  • Article

Deprecated. Adds another user to the current conversation.

Syntax

HRESULT AddContact(      
    VARIANT vContact
);

Parameters

  • vContact
    [in] VARIANT that can take as its value either a VT_BSTR or a VT_DISPATCH pointer to an existing MessengerContact object. If the input value type is a string, this method creates a new MessengerContact object internally. The string should be the full sign-in name. For a Microsoft .NET Messenger Service contact, this should include an "at" sign (@) and domain name. If the input value type is a pointer to an existing MessengerContact object (should be type VT_DISPATCH), the existing object is used for contact information.

Return Value

Returns one of the following values. 

S_OK Success.
E_INVALIDARG vContact is NULL, the wrong type, points to a NULL string, or points to a string that has a space as the first character; or, vContact is VT_BSTR that exceeded 129 characters; or, vContact is VT_BSTR and contains a carriage return or linefeed.
E_FAIL Client was not signed in to the primary service at the time this method was called; or, this method was called against the local client user.
S_FALSE String comparison failed.
MSGR_E_SESSION_FULL The current conversation window is hosting a voice or video conversation; or, the maximum number of participants allowed in the session has been reached.
MSGR_E_INVALID_SERVICE Called this method against a user belonging to a service other than the one to which the current conversation members belong.

Remarks

Note  This method is available for scripting languages.

Important  IMessengerConversationWnd::AddContact is no longer available in Windows Vista. See Windows Messenger for more information.

See Also

IMessengerConversationWnd