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 |
---|---|
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. |
|
Not supported. |
|
Retrieves the friendly name of the contact associated with this MessengerContact object. Scriptable only locally for getting the property value. |
|
Retrieves a Boolean value that declares whether the contact associated with this MessengerContact object is actually the current client user. Scriptable. |
|
Retrieves the phone number information for the contact associated with this MessengerContact object. Not scriptable. |
|
Retrieves the service ID, a globally unique identifier (GUID), for the contact associated with this MessengerContact object. Scriptable. |
|
Retrieves the service name of the contact associated with this MessengerContact object. Scriptable. |
|
Retrieves the sign-in name of the contact that is associated with this MessengerContact object. Scriptable only locally for getting the property value. |
|
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 |
---|---|
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