The IMessenger interface encapsulates the basic functionality of Microsoft® Office Communicator 2007. It includes utility methods and methods for displaying the Communicator UI and for getting or setting selected properties of the local client user.
The interface ID is D50C3186-0F89-48f8-B204-3604629DEE10 (IID_IMessenger).
Syntax
interface IMessenger : IDispatch |
Methods
The following table lists the methods exposed by the IMessenger interface.
Name | Description |
---|---|
Starts the Add a Contact Wizard to add a contact to the contact list of the signed-in user. Not scriptable. |
|
Signs the local client in automatically using the last sign-in name and saved password information. Scriptable. |
|
Starts the Add a Contact Wizard to the screen used for finding a contact based on information supplied as input parameters. Not scriptable. |
|
Gets a MessengerContact object that can be manipulated with the IMessengerContact interface for given user. Scriptable. |
|
Starts a conversation window with the initial recipient specified as a parameter. Scriptable. |
|
Not supported. |
|
Gets the logged-on user's telephone number based on the telephone number type specified in the input parameter |
|
Reserved. Do not use. |
|
Not supported. |
|
Not supported. |
|
Not supported. |
|
Starts the Phone Call dialog box. Not scriptable. |
|
Not supported. |
|
Not supported. |
|
Starts the Communicator client Sign In dialog box and populates the sign-in name field. The behavior of this method varies, depending on the client version, host operating system, and primary service for the client. Scriptable. |
|
Signs out the client user. Not scriptable. |
|
Starts a Communicator conversation window to initiate a voice session with a particular contact, pending acceptance of the invitation. Not scriptable. |
|
Not supported. |
|
Not supported. |
|
Not supported |
Properties
Name | Description |
---|---|
Retrieves the contact list that is contained in the client or the Messenger object. The retrieved list is a MessengerContacts collection object that can be manipulated with the IMessengerContacts interface. Scriptable for scripts not running inside a Web page. |
|
Retrieves the friendly (display) name of the local client user. Scriptable for scripts not running inside a Web page. |
|
Retrieves the service ID, a globally unique identifier (GUID), of the primary service to which the local client user is currently signed in. Scriptable. |
|
Retrieves the friendly service name of the primary service to which the local client user is currently signed in. Not scriptable. |
|
Retrieves the sign-in name. Not scriptable. |
|
Provides the user status of the calling client. Scriptable for scripts not running inside a Web page to get the property value. |
|
Not supported. |
|
Returns a list of services that the Communicator client uses. Scriptable. |
|
Gets a pointer to an IMessengerWindow object that is used to control automation properties of the main application window, including dimensions, positioning, and visibility. Scriptable. |
Subclasses
The following table lists the subclasses exposed by the IMessenger interface.
Name | Description |
---|---|
The IMessenger interface encapsulates the basic functionality of Microsoft® Office Communicator 2007. It includes utility methods and methods for displaying the Communicator UI and for getting or setting selected properties of the local client user. |
Inheritance Hierarchy
IDispatch
IMessenger
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