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 .gif) |
|---|
| Header and IDL files | msgrua.h, msgrua.idl |
|---|
| Minimum availability | Messenger
4.0 |
|---|
| Minimum operating systems |
Windows XP |
|---|