IMessenger::OpenInbox method

[IMessenger::OpenInbox is no longer available for use as of Windows Vista. For more information, see Windows Messenger.]

Launches the default email application and opens the Inbox.

Calling IMessenger::OpenInbox on the Microsoft Exchange client version will open the user's Exchange Inbox instead of a webpage to or any registered default mailto: application. Otherwise, this method will return valid results only if Microsoft .NET Messenger Service is the primary and active service.


HRESULT OpenInbox();


This method has no parameters.

Return value


For a table of MSGR_E_* constants, see MSGRConstants.

Returns one of the following values.

Return code Description
Client is offline.
General failure.


When this method is invoked on a Exchange Instant Messaging Service (IM) client, Exchange through Microsoft Outlook will always be invoked as the email client. Calling this method will launch or focus the 32-bit Outlook application with the Inbox open.

At sign-in, the Messenger client internally flags whether the Microsoft .NET Messenger Service user has an Inbox. If so, a browser instance will be opened to the Inbox. If the user does not have an Inbox, then a default mailto: is thrown to the operating system, which opens the mail client registered to handle this protocol in the Windows Internet Explorer browser. This behavior is identical to enabling the My E-mail Inbox menu options in the UI.

To use this method with Windows Messenger, you must install an add-in component that supports email integration.

The Microsoft .NET Messenger Service includes and is able to authenticate not just Microsoft users, but any user with a Windows Live ID. Microsoft .NET Messenger Service users may or may not have email accounts associated with their sign-in names. Users of always have email accounts associated with their sign-in names used for Messenger. Users of may use the Microsoft .NET Messenger Service and authenticate through Windows Live ID into the Microsoft .NET Messenger Service, but these users do not have a corresponding email account with Windows Live ID also supports email name as sign-in name (EASI), which means that a user can sign in through Windows Live ID to the Microsoft .NET Messenger Service with a sign-in name that does not have either the or "" suffix. In the EASI case, this sign-in name can be verified to be a legitimate email address because the person who established this Windows Live ID account must be able to respond to a verification email that is sent as part of the Windows Live ID registration process.

Services other than the Microsoft .NET Messenger Service and Exchange IM might not follow email conventions for sign-in names, in which case the OpenInbox method will not be useful.


This method is available for scripting languages.


Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
End of client support
Windows XP
End of server support
Windows Server 2003

See also