Share via


IMessenger::MediaWizard method

[MediaWizard is no longer available for use as of 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]

Type: long

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

Return value

Type: HRESULT

For a table of MSGR_E_* constants, see MSGRConstants.

Returns one of the following values.

Return code Description
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

End of client support
Windows XP
End of server support
Windows Server 2003
Header
Msgrua.h
IDL
Msgrua.idl
DLL
Msgsc.dll