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

IMessenger::AddContact

Starts the Add a Contact Wizard to add a contact to the contact list of the signed-in user.

Not scriptable.

IMessenger::AutoSignin

Signs the local client in automatically using the last sign-in name and saved password information.

Scriptable.

IMessenger::FindContact

Starts the Add a Contact Wizard to the screen used for finding a contact based on information supplied as input parameters.

Not scriptable.

IMessenger::GetContact

Gets a MessengerContact object that can be manipulated with the IMessengerContact interface for given user.

Scriptable.

IMessenger::InstantMessage

Starts a conversation window with the initial recipient specified as a parameter.

Scriptable.

IMessenger::InviteApp

Not supported.

IMessenger::get_MyPhoneNumber

Gets the logged-on user's telephone number based on the telephone number type specified in the input parameter

IMessenger::get_MyProperty

Reserved. Do not use.

IMessenger::OpenInbox

Not supported.

IMessenger::OptionsPages

Not supported.

IMessenger::Page

Not supported.

IMessenger::Phone

Starts the Phone Call dialog box.

Not scriptable.

IMessenger::SendFile

Not supported.

IMessenger::SendMail

Not supported.

IMessenger::Signin

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.

IMessenger::Signout

Signs out the client user.

Not scriptable.

IMessenger::StartVoice

Starts a Communicator conversation window to initiate a voice session with a particular contact, pending acceptance of the invitation.

Not scriptable.

IMessenger::get_UnreadEmailCount

Not supported.

IMessenger::ViewProfile

Not supported.

IMessenger::MediaWizard Method

Not supported

Properties

Name Description

IMessenger::MyContacts

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.

IMessenger::MyFriendlyName

Retrieves the friendly (display) name of the local client user.

Scriptable for scripts not running inside a Web page.

IMessenger::MyServiceId

Retrieves the service ID, a globally unique identifier (GUID), of the primary service to which the local client user is currently signed in.

Scriptable.

IMessenger::MyServiceName

Retrieves the friendly service name of the primary service to which the local client user is currently signed in. Not scriptable.

IMessenger::MySigninName

Retrieves the sign-in name. Not scriptable.

IMessenger::MyStatus

Provides the user status of the calling client.

Scriptable for scripts not running inside a Web page to get the property value.

IMessenger::ReceiveFileDirectory

Not supported.

IMessenger::Services

Returns a list of services that the Communicator client uses.

Scriptable.

IMessenger::Window

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

IMessenger2

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

See Also

Reference

Interfaces