IWMPPluginUI::SetProperty method (wmpplug.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 SetProperty method is called by Windows Media Player to set name/value property pairs for the plug-in.
Syntax
HRESULT SetProperty(
[in] const WCHAR *pwszName,
[in] const VARIANT *pvarProperty
);
Parameters
[in] pwszName
Pointer to a WCHARNULL-terminated string constant containing the name of the property. Contains one of the following values:
| Value | Description |
|---|---|
| PLUGIN_MISC_CURRENTPRESET = L"CurrentPreset" | The pvarProperty parameter contains a Long (VT_I4) value that specifies the index of the plug-in preset which is to be made current. |
| PLUGIN_ALL_MEDIASENDTO = L"MediaSendTo" | The pvarProperty parameter contains an array of IUnknown (VT_ARRAY | VT_UNKNOWN) pointers for Media objects that are sent to the plug-in from the Playlist control. |
| PLUGIN_ALL_PLAYLISTSENDTO = L"PlaylistSendTo" | The pvarProperty parameter contains an array of IUnknown (VT_ARRAY | VT_UNKNOWN) pointers for Playlist objects that are sent to the plug-in from the library. |
[in] pvarProperty
Pointer to a VARIANT containing the new value of the property.
Return value
This method returns an HRESULT.
Remarks
Windows Media Player determines the type and capabilities of a plug-in by checking the Windows registry, and will specify only properties that the plug-in supports.
Media and Playlist objects are sent to the plug-in as arrays of IUnknown pointers. The plug-in can call QueryInterface on these pointers to retrieve IWMPMedia or IWMPPlaylist interfaces.
Windows Media Player 10 Mobile: This method is not supported.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Media Player 9 Series or later. |
| Target Platform | Windows |
| Header | wmpplug.h |