IWMPSyncDevice::showSettings method (wmp.h)
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The showSettings method displays the Windows Media Player synchronization settings dialog box.
Syntax
HRESULT showSettings();
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
The device is not connected. |
|
Windows Media Player is currently busy initializing devices. Please try again later. |
|
The status for the current device is wmpdsManualDevice. |
|
The current status for the device is wmpdsPartnershipDeclined, wmpdsPartnershipAnother, or wmpdsNewDevice. This method only shows the settings dialog box for devices for which a partnership exists with the current instance of Windows Media Player. |
Remarks
The remoted instance of Windows Media Player undocks, if necessary, and shows the device settings dialog box. If the Player was in skin mode, it returns to full mode. If the Player is locked in skin mode by corporate policy, the call fails.
When the user closes the dialog box, Windows Media Player returns to its original docking state.
Note that the events for docking and undocking Windows Media Player will occur normally.
Windows Media Player 10 Mobile: This method is not supported.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Media Player 10 or later. |
| Target Platform | Windows |
| Header | wmp.h |
| DLL | Wmp.dll |