IMessengerContact interface

[IMessengerContact is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

Do not use. 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.

Members

The IMessengerContact interface inherits from the IDispatch interface. IMessengerContact also has these types of members:

• Properties

Properties

The IMessengerContact interface has these properties.

Property	Access type	Description
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	Read-only	Retrieves a Boolean value that declares whether the contact associated with this MessengerContact object has mobile preferences established or visible.
FriendlyName	Read-only	Retrieves the friendly name of the contact associated with this MessengerContact object.
IsSelf	Read-only	Retrieves a Boolean value that declares whether the contact associated with this MessengerContact object is actually the current client user.
PhoneNumber	Read-only	Retrieves the phone number information for the contact associated with this MessengerContact object.
Property		Reserved.
ServiceID	Read-only	Retrieves the service ID, a GUID, for the contact associated with this MessengerContact object.
ServiceName	Read-only	Retrieves the service name of the contact associated with this MessengerContact object.
SigninName	Read-only	Retrieves the sign-in name of the contact associated with this MessengerContact object.
Status	Read-only	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 InstantMessage method even if that contact does not exist in the local contact list.

To create a MessengerContact object, use the 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.

Requirements

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
Product	Messenger 4.0
Header	Msgrua.h
IDL	Msgrua.idl
DLL	Msgsc.dll