IMessenger::OpenInbox Method
Deprecated. Launches the default e-mail application and opens the Inbox.
Syntax
HRESULT OpenInbox(VOID);
Return Value
For a table of MSGR_E_* constants, see MSGRConstants.
Returns one of the following values:
S_OK Success. MSGR_E_NOT_LOGGED_ON Client is offline. E_FAIL General failure.
Remarks
When this method is invoked on a Microsoft Exchange Instant Messaging Service (IM) client, Exchange through Microsoft Outlook will always be invoked as the e-mail 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 a MSN Hotmail Inbox. If so, a browser instance will be opened to the Hotmail Inbox. If the user does not have a Hotmail Inbox, then a default mailto: is thrown to the operating system, which opens the mail client registered to handle this protocol in the Microsoft Internet Explorer browser. This behavior is identical to enabling the My E-mail Inbox menu options in the user interface (UI).
To use this method with Microsoft Windows Messenger, you must install an add-in component that supports e-mail integration.
Note Calling IMessenger::OpenInbox on the Exchange client version will open the user's Exchange Inbox instead of a Web page to Hotmail or any registered default mailto: application. Otherwise, this method will return valid results only if .NET Messenger Service is the primary and active service.
The .NET Messenger Service includes and is able to authenticate not just @hotmail.com users, but any user with a Windows Live ID. .NET Messenger Service users may or may not have e-mail accounts associated with their sign-in names. Users of @hotmail.com always have e-mail accounts associated with their sign-in names used for Messenger. Users of @passport.com may use the .NET Messenger Service and authenticate through Windows Live ID into the .NET Messenger Service, but these users do not have a corresponding e-mail account with Passport.com.Windows Live ID also supports e-mail name as sign-in name (EASI), which means that a user can sign in through Windows Live ID to the .NET Messenger Service with a sign-in name that does not have either the @passport.com or @hotmail.com suffix. In the EASI case, this sign-in name can be verified to be a legitimate e-mail address because the person who established this Windows Live ID account must be able to respond to a verification e-mail that is sent as part of the Windows Live ID registration process.
Services other than the .NET Messenger Service and Exchange IM might not follow e-mail conventions for sign-in names, in which case the IMessenger::OpenInbox method will not be useful.
Important IMessenger::OpenInbox is no longer available in Windows Vista. See Windows Messenger for more information.
Note This method is available for scripting languages.
See Also