Export (0) Print
Expand All

IMessengerContact

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).


interface IMessengerContact : IDispatch

The IMessengerContact interface exposes no methods.

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.

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

Name Description

IMessengerContactAdvanced

Messenger Contact Advanced for IMessenger.

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.

IDispatch

   IMessengerContact

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

Community Additions

ADD
Show:
© 2015 Microsoft