Messenger::OpenChat

The Messenger::OpenChat function opens a chat window with the specified contact. If a chat window with this contact is already opened, the window is activated.

Syntax

[object] OpenChat(
    [var] Contact
);

Parameters

Contact

[var] A string containing the email of the contact or a Contact object.

Return Value

A ChatWnd object if the function succeeds or null if it fails.

This function typically fails for the following reason:

• The current Messenger user is not signed in.

Remarks

By default, if an email string is specified for Contact, this function searches for both Windows Live and Yahoo Messenger contacts. If the current user has twice the same contact in its list, both using the same sign-in email for Windows Live and Yahoo, the contact object returned by default will always be the one connected on Windows Live. You can force a request for contacts on the Yahoo network by prefixing the email with "yahoo:".

Function Information

See Also

Messenger Object, ChatWnd Object, Contact::Network.