Share via


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

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