IMessengerContact

  • Article

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

This interface encapsulates a user whose account is maintained by a Communications Server and whose contact information and presence status can be displayed in Communicator or in an application.

The interface ID is E7479A0F-BB19-44a5-968F-6F41D93EE0BC (IID_IMessengerContact).

Syntax

interface IMessengerContact : IDispatch

Methods

The IMessengerContact interface exposes no methods.

Properties

The table contains the following properties.

Name Description

IMessengerContact::Blocked

Sets or retrieves a Boolean value that declares whether the contact associated with this MessengerContact object is blocked by the current client user.

Not scriptable.

IMessengerContact::CanPage

Not supported.

IMessengerContact::FriendlyName

Retrieves the friendly name of the contact associated with this MessengerContact object.

Scriptable only locally for getting the property value.

IMessengerContact::IsSelf

Retrieves a Boolean value that declares whether the contact associated with this MessengerContact object is actually the current client user.

Scriptable.

IMessengerContact::get_PhoneNumber

Retrieves the phone number information for the contact associated with this MessengerContact object.

Not scriptable.

IMessengerContact::ServiceId

Retrieves the service ID, a globally unique identifier (GUID), for the contact associated with this MessengerContact object.

Scriptable.

IMessengerContact::ServiceName

Retrieves the service name of the contact associated with this MessengerContact object.

Scriptable.

IMessengerContact::SigninName

Retrieves the sign-in name of the contact that is associated with this MessengerContact object.

Scriptable only locally for getting the property value.

IMessengerContact::Status

Retrieves the connection status of the contact associated with the MessengerContact object.

Scriptable.

Subclasses

The following table lists the subclasses exposed by the IMessengerContact interface.

Name Description

IMessengerContactAdvanced

Messenger Contact Advanced for IMessenger.

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 or IMessenger::AddContact method. You create new MessengerContact objects by sign-in name. When you use GetContact to return a MessengerContact object, you are not necessarily creating a new contact. If a MessengerContact object already exists for that sign-in name, this method references the existing object instead of creating a new one. By default, the MessengerContact object returned is added to your "Other Contacts" group. The contact can be moved to one of your user-defined contact groups with a call to the IMessengerGroup::AddContact method.

Inheritance Hierarchy

IDispatch

   IMessengerContact

Requirements

  • Client
    Requires Microsoft DirectX 9.0, C Runtime libraries (msvcm80.dll) on Microsoft Windows© Vista, Microsoft Windows XP Service Pack 1 (SP1) or later, or Microsoft Windows 2000 with Service Pack 4 (SP4). Any Communicator-imposed restrictions apply. .
  • Server
    Requires Microsoft Office Communications Server 2007, AV MCU (for Media Support), Media Relay (for NAT/Firewall traversal) on Microsoft Office Communications Server 2007.
  • Product
    Microsoft Office Communicator 2007 Automation API
  • IDL file
    Msgrua.idl

See Also

Reference

Interfaces