IMessengerContact Interface

Deprecated. The primary interface for an individual MessengerContact object (the local representation of a remote user). Each contact in the contact list exists as its own MessengerContact object.

IMessengerContact Members

Blocked Sets or retrieves a Boolean value that declares whether the contact associated with this MessengerContact object is blocked by the current client user.
CanPage Retrieves a Boolean value that declares whether the contact associated with this MessengerContact object has mobile preferences established or visible.
FriendlyName Retrieves the friendly name of the contact associated with this MessengerContact object.
IsSelf Retrieves a Boolean value that declares whether the contact associated with this MessengerContact object is actually the current client user.
PhoneNumber Retrieves the phone number information for the contact associated with this MessengerContact object.
Property Reserved.
ServiceID Retrieves the service ID, a GUID, for the contact associated with this MessengerContact object.
ServiceName Retrieves the service name of the contact associated with this MessengerContact object.
SigninName Retrieves the sign-in name of the contact associated with this MessengerContact object.
Status Retrieves the connection status of the contact associated with the MessengerContact object.

Remarks

MessengerContact objects are also occasionally created or used for other purposes. For example, a MessengerContact object can be used as the parameter input for the IMessenger::InstantMessage method even if that contact does not exist in the local contact list.

To create a MessengerContact object, use the IMessenger::GetContact method. You create new MessengerContact objects by sign-in name. When you are creating a MessengerContact object, you are not necessarily creating a new contact until you place the new MessengerContact object into the contact list. If a MessengerContact object already exists for that sign-in name, this method will reference the existing object instead of creating a new one.

Important  IMessengerContact is no longer available in Windows Vista. See Windows Messenger for more information.

Interface Information

Stock Implementation msgsc.dll
Custom Implementation No
Inherits from IDispatch World Wide Web link
Header and IDL files msgrua.h, msgrua.idl
Minimum availability Messenger 4.0
Minimum operating systems Windows XP