Windows Messenger Client Reference

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

This documentation provides information about the Windows Messenger API which is a set of interfaces for objects related to the Messenger client. These APIs expose standard automation, messaging, and window management functionality.

New applications should not use this set of interfaces. These interfaces exist for backward compatibility with legacy applications. These interfaces will be unavailable in the future.

The Messenger interfaces include the basic object interface; several interfaces that house entities such as users, windows, and lists; and an event sink (connection point) interface.

Enums

[BASICIM_Constants](im-basicim-constants.md)Not currently supported.
[BIMSTATE](im-bimstate.md)Do not use. Specifies local or remote client state.
[!Note]
The [BIMSTATE](im-bimstate.md) enumerated type is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [MISTATUS](im-mistatus.md) instead.


[BIMUSERPROPERTY](im-bimuserproperty.md)Not currently supported.
[FONTSIZE](im-fontsize.md)Not currently supported.
[INFOBAR](im-infobar.md)Not currently supported.
[MCONNECTIONTYPE](im-mconnectiontype.md)Not currently supported.
[MCONTACTPROPERTY](im-mcontactproperty.md)Do not use. Used to ask for the property that indicates which groups a user belongs to, or the contact's e-mail address.
[MFILETRANSFER_FLAGS](im-mfiletransfer-flags.md)Not currently supported.
[MFIRSTTIME_FLAGS](im-mfirsttime-flags.md)Not currently supported.
[MFOLDER](im-mfolder.md)Not currently supported.
[MINVITE_FLAGS](im-minvite-flags.md)Not currently supported.
[MISTATUS](im-mistatus.md)Do not use. Specifies local or remote client state. The user can select these options from the File menu of the Messenger window or by clicking the Messenger icon in the taskbar. The current state of the local user is detected on the local client. The current state of the remote clients is detected through the server automatically. Not all states are valid for remote clients.
[MLIST](im-mlist.md)Do not use. Used to retrieve information about contact lists.
[!Note]
The [MLIST](im-mlist.md) enumerated type is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger.


[MLOCALOPTION](im-mlocaloption.md)Not currently supported.
[MLOCALOPTION_LIMITS](im-mlocaloption-limits.md)Not currently supported.
[MMESSENGERPROPERTY](im-mmessengerproperty.md)Do not use. Used to retrieve the Messenger client version and client locale ID (LCID).
[MMSGPRIVACY](im-mmsgprivacy.md)Not currently supported.
[MMSGTYPE](im-mmsgtype.md)Not currently supported.
[MOPTDLGPAGE](im-moptdlgpage.md)Do not use. Specifies which page of the Messenger client Options dialog box to display to the user.
[!Note]
The [MOPTDLGPAGE](im-moptdlgpage.md) enumerated type is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [MOPTIONPAGE](im-moptionpage.md) instead.


[MOPTIONPAGE](im-moptionpage.md)Do not use. Specifies which page of the Messenger client Options dialog box to display to the user through the user interface (UI) and several related tracking constants.
[MPFLFIELD](im-mpflfield.md)Not currently supported.
[MPHONE_TYPE](im-mphone-type.md)Do not use. Specifies which phone number of a given contact is used.
[MPROMPT](im-mprompt.md)Not currently supported.
[MPROXYTYPE](im-mproxytype.md)Not currently supported.
[MSERVICEPROPERTY](im-mserviceproperty.md)Do not use. Used to ask for the property of a service.
[MSERVICE_FLAGS](im-mservice-flags.md)Not currently supported.
[MSGRConstants](im-msgrconstants.md)Do not use. The following are constants used for error and success returns of methods and properties of the Windows Messenger APIs.
[MSGRConstants](im-msgrobject-msgrconstants.md)Do not use. The following are constants used for error or success returns of methods and properties of the Windows Messenger APIs.
[!Note]
The [MSGRConstants](im-msgrobject-msgrconstants.md) enumerated type is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [MSGRConstants](im-msgrconstants.md) instead.


[MSTATE](im-mstate.md)Do not use. Specifies local or remote client state.
[!Note]
The [MSTATE](im-mstate.md) enumerated type is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [MISTATUS](im-mistatus.md) instead.


[MSVCSTATUS](im-msvcstatus.md)Not currently supported.
[MUAFOLDER](im-muafolder.md)Do not use. Used for selecting the folder for the count of unread messages.
[MUASORT](im-muasort.md)Do not use. Specifies how the Contact List should be sorted.
[MUPDATE_FLAGS](im-mupdate-flags.md)Not currently supported.
[MURLTYPE](im-murltype.md)Not currently supported.
[MUSERPROPERTY](im-muserproperty.md)Not currently supported.
[MWINDOWPROPERTY](im-mwindowproperty.md)Do not use. Used to turn on or off the conversation window sidebar and toolbar.
[SSTATE](im-sstate.md)Not currently supported.
[VOICESESSIONSTATE](im-voicesessionstate.md)Not currently supported.

Events

[OnAppShutdown](im-dbasicimevents-onappshutdown.md)Not currently supported.
[OnContactListAddResult](im-dbasicimevents-oncontactlistaddresult.md)Not currently supported.
[OnContactListRemoveResult](im-dbasicimevents-oncontactlistremoveresult.md)Not currently supported.
[OnLocalStateChangeResult](im-dbasicimevents-onlocalstatechangeresult.md)Not currently supported.
[OnLogoff](im-dbasicimevents-onlogoff.md)Indicates that the logoff is complete.
[!Note]
The [OnLogoff](im-dbasicimevents-onlogoff.md) event is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [OnSignout](im-dmessengerevents-onsignout.md) instead.


[OnLogonResult](im-dbasicimevents-onlogonresult.md)Not currently supported.
[OnUserFriendlyNameChangeResult](im-dbasicimevents-onuserfriendlynamechangeresult.md)Not currently supported.
[OnUserStateChanged](im-dbasicimevents-onuserstatechanged.md)Indicates that the user's state has changed.
[!Note]
The [OnUserStateChanged](im-dbasicimevents-onuserstatechanged.md) event is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [OnContactStatusChange](im-dmessengerevents-oncontactstatuschange.md) instead.


[OnBeforeLaunchIMUI](im-dmsgrobjectevents-onbeforelaunchimui.md)Not currently supported.
[OnDestroyIMUI](im-dmsgrobjectevents-ondestroyimui.md)Not currently supported.
[OnFileTransferIMUI](im-dmsgrobjectevents-onfiletransferimui.md)Not currently supported.
[OnIndicateMessageReceivedIMUI](im-dmsgrobjectevents-onindicatemessagereceivedimui.md)Not currently supported.
[OnInfobarTextIMUI](im-dmsgrobjectevents-oninfobartextimui.md)Not currently supported.
[OnMicrophoneMuteIMUI](im-dmsgrobjectevents-onmicrophonemuteimui.md)Not currently supported.
[OnSendEnabledIMUI](im-dmsgrobjectevents-onsendenabledimui.md)Not currently supported.
[OnShowIMUI](im-dmsgrobjectevents-onshowimui.md)Not currently supported.
[OnStatusTextIMUI](im-dmsgrobjectevents-onstatustextimui.md)Not currently supported.
[OnTitlebarTextIMUI](im-dmsgrobjectevents-ontitlebartextimui.md)Not currently supported.
[OnVoiceSessionStateIMUI](im-dmsgrobjectevents-onvoicesessionstateimui.md)Not currently supported.
[OnAppShutdown](im-dmessengerevents-onappshutdown.md)Indicates that the client application is about to shut down for purposes of a client upgrade initiated either by the server or client user.
[OnContactAddedToGroup](im-dmessengerevents-oncontactaddedtogroup.md)Indicates that a contact has been added to a group.
[OnContactBlockChange](im-dmessengerevents-oncontactblockchange.md)Indicates that the block settings of a contact in the local client's Contact List have changed. Queries whether the contact is blocked by the local client user.
[OnContactFriendlyNameChange](im-dmessengerevents-oncontactfriendlynamechange.md)Indicates that a contact in the client's Contact List has changed the friendly name.
[OnContactListAdd](im-dmessengerevents-oncontactlistadd.md)Indicates the result of an attempt to add to the [Messenger](im-messenger.md) object's Contact List.
[OnContactListRemove](im-dmessengerevents-oncontactlistremove.md)Indicates the result of an attempt to remove a contact from the [Messenger](im-messenger.md) object's Contact List.
[OnContactPagerChange](im-dmessengerevents-oncontactpagerchange.md)Indicates that a contact in the local client's Contact List has changed the pager information access permissions.
[OnContactPhoneChange](im-dmessengerevents-oncontactphonechange.md)Indicates that the phone information of a contact in the local client's Contact List has changed.
[OnContactPropertyChange](im-dmessengerevents-oncontactpropertychange.md)Indicates that property information for a contact in the local client's Contact List has changed.
[OnContactRemovedFromGroup](im-dmessengerevents-oncontactremovedfromgroup.md)Indicates that a contact has been removed from a group.
[OnContactStatusChange](im-dmessengerevents-oncontactstatuschange.md)Indicates that the status of a contact in the local client's Contact List has changed, and returns the current state of the contact.
[OnGroupAdded](im-dmessengerevents-ongroupadded.md) Indicates that a new group has been created.
[OnGroupNameChanged](im-dmessengerevents-ongroupnamechanged.md) Indicates that the name of a group has been changed.
[OnGroupRemoved](im-dmessengerevents-ongroupremoved.md)Indicates that a group has been deleted.
[OnIMWindowContactAdded](im-dmessengerevents-onimwindowcontactadded.md) Indicates that a contact has been added to the ongoing conversation.
[OnIMWindowContactRemoved](im-dmessengerevents-onimwindowcontactremoved.md) Indicates that a contact has been removed from the ongoing conversation.
[OnIMWindowCreated](im-dmessengerevents-onimwindowcreated.md) Indicates that a new conversation window has been opened.
[OnIMWindowDestroyed](im-dmessengerevents-onimwindowdestroyed.md)Indicates that a new conversation window has been closed.
[OnMyFriendlyNameChange](im-dmessengerevents-onmyfriendlynamechange.md) Indicates that the local client's friendly name has been changed or that a change was attempted.
[OnMyPhoneChange](im-dmessengerevents-onmyphonechange.md) Indicates that the local client's phone contact information has been changed or that a change was attempted.
[OnMyPropertyChange](im-dmessengerevents-onmypropertychange.md)Indicates that an uncategorized element of the local client's property information has been changed or that a change was attempted.
[OnMyStatusChange](im-dmessengerevents-onmystatuschange.md)Indicates that the status of the local client has changed or that a status change was attempted, and returns the current status of the local client.
[OnSignin](im-dmessengerevents-onsignin.md)Indicates that an attempt has been made to sign in to the primary service.
[OnSignout](im-dmessengerevents-onsignout.md)Indicates that the local client has signed out of the primary service.
[OnUnreadEmailChange](im-dmessengerevents-onunreademailchange.md)Indicates the number of unread e-mail messages in the Messenger client's correlated Outlook.com Inbox that have changed from the last count of previous [OnUnreadEmailChange](im-dmessengerevents-onunreademailchange.md) events or initial sign-in.
[OnAppInviteAccepted](im-dmsgrobjectevents-onappinviteaccepted.md)Not currently supported.
[OnAppInviteCancelled](im-dmsgrobjectevents-onappinvitecancelled.md)Not currently supported.
[OnAppInviteReceived](im-dmsgrobjectevents-onappinvitereceived.md)Not currently supported.
[OnAppShutDown](im-dmsgrobjectevents-onappshutdown.md)Not currently supported.
[OnBuddyPropertyChangeResult](im-dmsgrobjectevents-onbuddypropertychangeresult.md)Not currently supported.
[OnFileTransferCancelled](im-dmsgrobjectevents-onfiletransfercancelled.md)Not currently supported.
[OnFileTransferInviteAccepted](im-dmsgrobjectevents-onfiletransferinviteaccepted.md)Not currently supported.
[OnFileTransferInviteCancelled](im-dmsgrobjectevents-onfiletransferinvitecancelled.md)Not currently supported.
[OnFileTransferInviteReceived](im-dmsgrobjectevents-onfiletransferinvitereceived.md)Not currently supported.
[OnFileTransferStatusChange](im-dmsgrobjectevents-onfiletransferstatuschange.md)Not currently supported.
[OnFindResult](im-dmsgrobjectevents-onfindresult.md)Not currently supported.
[OnInviteMailResult](im-dmsgrobjectevents-oninvitemailresult.md)Not currently supported.
[OnInviteUser](im-dmsgrobjectevents-oninviteuser.md)Not currently supported.
[OnListAddResult](im-dmsgrobjectevents-onlistaddresult.md)Indicates the result of an attempt to add to the Messenger User object's User List.
[!Note]
The [OnListAddResult](im-dmsgrobjectevents-onlistaddresult.md) event is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [OnContactListAdd](im-dmessengerevents-oncontactlistadd.md) instead.


[OnListRemovedResult](im-dmsgrobjectevents-onlistremoveresult.md)Indicates the result of an attempt to remove a user from the Messenger User object's User List.
[!Note]
The [OnListRemovedResult](im-dmsgrobjectevents-onlistremoveresult.md) event is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [OnContactListRemove](im-dmessengerevents-oncontactlistremove.md) instead.


[OnLocalFriendlyNameChangeResult](im-dmsgrobjectevents-onlocalfriendlynamechangeresult.md)Indicates that the settings of a user in the local client's User List have changed.
[!Note]
The [OnLocalFriendlyNameChangeResult](im-dmsgrobjectevents-onlocalfriendlynamechangeresult.md) event is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [OnMyFriendlyNameChange](im-dmessengerevents-onmyfriendlynamechange.md) instead.


[OnLocalPropertyChangeResult](im-dmsgrobjectevents-onlocalpropertychangeresult.md)Not currently supported.
[OnLocalStateChangeResult](im-dmsgrobjectevents-onlocalstatechangeresult.md)Indicates that the status of the local client has been changed or that a status change was attempted.
[!Note]
The [OnLocalStateChangeResult](im-dmsgrobjectevents-onlocalstatechangeresult.md) event is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [OnMyStatusChange](im-dmessengerevents-onmystatuschange.md) instead.


[OnLogonoff](im-dmsgrobjectevents-onlogonoff.md)Not currently supported.
[OnLogonResult](im-dmsgrobjectevents-onlogonresult.md)Indicates that an attempt has been made to sign in to the primary service.
[!Note]
The [OnLogonResult](im-dmsgrobjectevents-onlogonresult.md) event is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [OnSignin](im-dmessengerevents-onsignin.md) instead.


[OnMessagePrivacyChangeResult](im-dmsgrobjectevents-onmessageprivacychangeresult.md)Not currently supported.
[OnNewerClientAvailable](im-dmsgrobjectevents-onnewerclientavailable.md)Not currently supported.
[OnNewSessionRequest](im-dmsgrobjectevents-onnewsessionrequest.md)Not currently supported.
[OnNotificationReceived](im-dmsgrobjectevents-onnotificationreceived.md)Not currently supported.
[OnPrimaryServiceChanged](im-dmsgrobjectevents-onprimaryservicechanged.md)Not currently supported.
[OnPromptChangeResult](im-dmsgrobjectevents-onpromptchangeresult.md)Not currently supported.
[OnRequestURLPostResult](im-dmsgrobjectevents-onrequesturlpostresult.md)Not currently supported.
[OnRequestURLResult](im-dmsgrobjectevents-onrequesturlresult.md)Not currently supported.
[OnSendResult](im-dmsgrobjectevents-onsendresult.md)Not currently supported.
[OnServiceLogonoff](im-dmsgrobjectevents-onservicelogonoff.md)Not currently supported.
[OnSessionStateChange](im-dmsgrobjectevents-onsessionstatechange.md)Not currently supported.
[OnSPMessageReceived](im-dmsgrobjectevents-onspmessagereceived.md)Not currently supported.
[OnTextReceived](im-dmsgrobjectevents-ontextreceived.md)Indicates that a message has been received.
[!Note]
The [OnTextReceived](im-dmsgrobjectevents-ontextreceived.md) event is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger.


[OnTrustChanged](im-dmsgrobjectevents-ontrustchanged.md)Not currently supported.
[OnUnreadEmailChanged](im-dmsgrobjectevents-onunreademailchanged.md)Not currently supported.
[OnUserDropped](im-dmsgrobjectevents-onuserdropped.md)Not currently supported.
[OnUserFriendlyNameChangeResult](im-dmsgrobjectevents-onuserfriendlynamechangeresult.md)Indicates that a user in the User List has changed his or her friendly name.
[!Note]
The [OnUserFriendlyNameChangeResult](im-dmsgrobjectevents-onuserfriendlynamechangeresult.md) event is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [OnContactFriendlyNameChange](im-dmessengerevents-oncontactfriendlynamechange.md) instead.


[OnUserJoin](im-dmsgrobjectevents-onuserjoin.md)Not currently supported.
[OnUserLeave](im-dmsgrobjectevents-onuserleave.md)Not currently supported.
[OnUserStateChanged](im-dmsgrobjectevents-onuserstatechanged.md)Not currently supported.

DispInterfaces

[DBasicIMEvents](im-dbasicimevents.md)Do not use. The [DBasicIMEvents](im-dbasicimevents.md) dispinterface handles events that are generated or received by a [BasicIMObject](im-basicimobject.md) object.
[!Note]
The [DBasicIMEvents](im-dbasicimevents.md) dispinterface is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [DMessengerEvents](im-dmessengerevents.md) instead.


[DMessengerAppEvents](im-dmessengerappevents.md)Do not use. The [DMessengerAppEvents](im-dmessengerappevents.md) dispinterface handles events that are generated or received by a [MessengerApp](im-messengerapp.md) object.
[DMessengerEvents](im-dmessengerevents.md)Do not use. The [DMessengerEvents](im-dmessengerevents.md) dispinterface handles events that are generated or received by a [Messenger](im-messenger.md) object.
[DMsgrObjectEvents](im-dmsgrobjectevents.md)Do not use. The [DMsgrObjectEvents](im-dmsgrobjectevents.md) dispinterface handles events that are generated or received by a [MsgrObject](im-msgrobject.md) object.
[!Note]
The [DMsgrObjectEvents](im-dmsgrobjectevents.md) dispinterface is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [DMessengerEvents](im-dmessengerevents.md) instead.


Interfaces

[IBasicIM](im-ibasicim.md)Not currently supported.
[IBasicIMOld](im-ibasicimold.md)Do not use. Messenger Basic IM Object Interface - old version.
[!Note]
The [IBasicIMOld](im-ibasicimold.md) interface is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [IMessenger](im-imessenger.md) instead.


[IBasicIMUser](im-ibasicimuser.md)Do not use. Messenger User for an OE Private interface.
[!Note]
The [IBasicIMUser](im-ibasicimuser.md) interface is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [IMessenger](im-imessenger.md) instead.


[IBasicIMUser2](im-ibasicimuser2.md)Not currently supported.
[IBasicIMUsers](im-ibasicimusers.md)Not currently supported.
[IMessenger](im-imessenger.md)Do not use. The primary interface for Windows Messenger APIs calls. Includes methods for displaying Messenger client UI, getting or setting selected properties of the local client user, and utility methods.
[IMessenger2](im-imessenger2.md)Do not use. The secondary interface for the Windows Messenger API calls.
[IMessenger3](im-imessenger3.md)Do not use. The third interface for the Windows Messenger API calls.
[IMessengerApp](im-imessengerapp.md)Do not use. The [IMessengerApp](im-imessengerapp.md) interface provides methods and properties to handle Messenger applications.
[!Note]
The [IMessengerApp](im-imessengerapp.md) interface is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [IMessenger](im-imessenger.md) instead.


[IMessengerApp2](im-imessengerapp2.md)Not currently supported.
[IMessengerApp3](im-imessengerapp3.md)Not currently supported.
[IMessengerContact](im-imessengercontact.md)Do not use. The primary interface for an individual [MessengerContact](im-messengercontact.md) object (the local representation of a remote user). Each contact in the contact list exists as its own MessengerContact object.
[IMessengerContacts](im-imessengercontacts.md)Do not use. An interface that manipulates the contact list, which maintains a collection of users in a[Messenger](im-messenger.md)object.
[IMessengerConversationWnd](im-imessengerconversationwnd.md)Do not use. An interface that returns an [IDispatch](https://msdn.microsoft.com/windows/desktop/c1accca9-971c-4435-8a5e-e25404a3fb25) pointer to an [IMessengerContacts](im-imessengercontacts.md) collection that contains the participants of that conversation, excluding the local user. This is a read-only collection. [Remove](im-imessengergroups-remove.md) cannot be used on this collection.
[IMessengerGroup](im-imessengergroup.md)Do not use. The [IMessengerGroup](im-imessengergroup.md) interface provides methods and properties to handle a group's collection of users.
[IMessengerGroups](im-imessengergroups.md)Do not use. The [IMessengerGroups](im-imessengergroups.md) interface provides methods and properties to handle groups of users.
[IMessengerIMWindow](im-imessengerimwindow.md)Not currently supported.
[IMessengerIMWindows](im-imessengerimwindows.md)Not currently supported.
[IMessengerService](im-imessengerservice.md)Do not use. The primary interface for an individual [MessengerService](im-messengerservice.md) object.
[IMessengerServices](im-imessengerservices.md)Do not use. Manipulates the list of services.
[IMessengerWindow](im-imessengerwindow.md)Do not use. The automation interface for a Messenger window.
[IMsgrHost](im-imsgrhost.md)Not currently supported.
[IMsgrIMSession](im-imsgrimsession.md)Not currently supported.
[IMsgrIMSessions](im-imsgrimsessions.md)Not currently supported.
[IMsgrObject](im-imsgrobject.md)Do not use. The [IMsgrObject](im-imsgrobject.md) interface provides methods and properties to handle the Messenger Object.
[!Note]
The [IMsgrObject](im-imsgrobject.md) interface is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [IMessenger](im-imessenger.md) instead.


[IMsgrObject2](im-imsgrobject2.md)Not currently supported.
[IMsgrPassportClient](im-imsgrpassportclient.md)Not currently supported.
[IMsgrService](im-imsgrservice.md)Not currently supported.
[IMsgrServices](im-imsgrservices.md)Not currently supported.
[IMsgrSP](im-imsgrsp.md)Not currently supported.
[IMsgrSP2](im-imsgrsp2.md)Not currently supported.
[IMsgrUser](im-imsgruser.md)Not currently supported.
[IMsgrUser2](im-imsgruser2.md)Not currently supported.
[IMsgrUsers](im-imsgrusers.md)Do not use. The [IMsgrUsers](im-imsgrusers.md) interface provides methods and properties to handle the Messenger User object.
[!Note]
The [IMsgrUsers](im-imsgrusers.md) interface is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [IMessengerContacts](im-imessengercontacts.md) instead.


[IMsgrWebScriptManager](im-imsgrwebscriptmanager.md)Not currently supported.
[IMsnMessengerIMWindow](im-imsnmessengerimwindow.md)Not currently supported.
[IMsnMessengerIMWindow2](im-imsnmessengerimwindow2.md)Not currently supported.

Objects

[BasicIMObject](im-basicimobject.md)Do not use. The Windows Messenger Basic Instant Messaging Service (IM) object.
[!Note]
The [BasicIMObject](im-basicimobject.md) object is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [Messenger](im-messenger.md) instead.


[Messenger](im-messenger.md)Do not use. The [Messenger](im-messenger.md) object implements the [IMessenger3](im-imessenger3.md) interface and [DMessengerEvents](im-dmessengerevents.md) dispinterface. This object maintains lists of users and performs most automation functions.
[MessengerApp](im-messengerapp.md)Not currently supported.
[MessengerContact](im-messengercontact.md)Do not use. The [MessengerContact](im-messengercontact.md) object corresponds to the [IMessengerContact](im-imessengercontact.md) interface. This object provides a local representation of a remote contact. It represents a single user as stored in the [Messenger](im-messenger.md) object's internal contact list.
[MessengerContacts](im-messengercontacts.md)Do not use. The [MessengerContacts](im-messengercontacts.md) object corresponds to the [IMessengerContacts](im-imessengercontacts.md) interface. It is a collection object of contacts in the contact list.
[MessengerConversationWnd](im-messengerconversationwnd.md)Do not use. The [MessengerConversationWnd](im-messengerconversationwnd.md) object corresponds to the [IMessengerConversationWnd](im-imessengerconversationwnd.md) interface.
[MessengerGroup](im-messengergroup.md)Do not use. The [MessengerGroup](im-messengergroup.md) object corresponds to the [IMessengerGroup](im-imessengergroup.md) interface. It represents a single group as stored in the [Messenger](im-messenger.md) object's internal group list.
[MessengerGroups](im-messengergroups.md)Do not use. The [MessengerGroups](im-messengergroups.md) corresponds to the [IMessengerGroups](im-imessengergroups.md) interface. It is a collection object of groups in the contact list.
[MessengerNative](im-messengernative.md)Do not use. This is the native messenger object.
[MessengerService](im-messengerservice.md)Do not use. The [MessengerService](im-messengerservice.md) object corresponds to the [IMessengerService](im-imessengerservice.md) interface. This object represents a single service.
[MessengerServices](im-messengerservices.md)Do not use. The [MessengerServices](im-messengerservices.md) corresponds to the [IMessengerServices](im-imessengerservices.md) interface. It represents a list of services in the [Messenger](im-messenger.md) object.
[MessengerWindow](im-messengerwindow.md)Do not use. The [MessengerWindow](im-messengerwindow.md) object corresponds to the [IMessengerWindow](im-imessengerwindow.md) interface. This object can represent either the main application window or a conversation window that contains one or more active sessions between contacts and the local client user.
[MsgrObject](im-msgrobject.md)Do not use. The [MsgrObject](im-msgrobject.md) object.
[!Note]
The [MsgrObject](im-msgrobject.md) object is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger. You should use [Messenger](im-messenger.md) and [MessengerContacts](im-messengercontacts.md) instead.


Structures

LOGFONT_DATANot currently supported.