Export (0) Print
Expand All

IMessenger::MediaWizard Method

[MediaWizard is no longer available in Windows Vista. See Windows Messenger for more information.]

Launches the Audio and Video Tuning Wizard dialog box.

Syntax

HRESULT MediaWizard(
  [in]  long hwndParent
);

Parameters

hwndParent [in]
long

A LONG. Reserved. All current implementations or calls should set this parameter to 0 or NULL.

Return Value

HRESULT

For a table of MSGR_E_* constants, see MSGRConstants.

Returns one of the following values:

Return codeDescription
S_OK

Success.

- or -

The client is offline.

MSGR_E_CONTACT_UI_ACTIVE

Called this method while the Add a Contact or Find a Contact dialog box was enabled and visible.

MSGR_E_LOGON_UI_ACTIVE

Called this method while the Sign In dialog box was enabled and visible.

MSGR_E_OPTION_UI_ACTIVE

Called this method while the Options dialog box was enabled and visible.

MSGR_E_OTHER_UI_ACTIVE

Called this method while the Customer Experience Improvement Program(CEIP) dialog box was enabled and visible.

E_FAIL

Could not create the dialog box or the Messenger object is not responding.

 

Remarks

Only one Audio and Video Tuning Wizard dialog box can be active at one time. Calling MediaWizard multiple times returns S_OK.

Calling MediaWizard while the client is offline will display the dialog box with S_OK as HResult. This is identical to the behavior that results if a client user selects the Audio and Video Tuning Wizard menu option while offline.

If audio levels have not been set previously on the client, calling StartVoice will display the Audio and Video Tuning Wizard. Without properly tuned levels, voice communication is difficult or impossible.

Note  This method is available for scripting languages.

Requirements

Header

Msgrua.h

IDL

Msgrua.idl

DLL

Msgsc.dll

See Also

IMessenger

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010

Community Additions

ADD
Show:
© 2014 Microsoft