IWMCProperty::put_Value

banner art

This functionality is expected to be available in Windows Media Player for the next version of Microsoft Windows. At that time, this SDK will be deprecated.

The put_Value method specifies the value of the property.

Syntax

HRESULT put_Value(
  VARIANT*  Value
);

Parameters

Value

[in]  Pointer to a VARIANT that specifies the new value for the property.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.

Remarks

You cannot change the type of the property value when setting the value this way. If the property is a string and you pass in a number, it will automatically be converted to a string representation and stored. If you want to change the type of the property value, use IWMCProperties::AddString or IWMCProperties::AddNumber on the Properties object.

Only Administrators are allowed to change device properties.

Requirements

Library: wmcsci.dll.

Platform: Windows XP Home Edition Service Pack 2 (SP2), Windows XP Professional SP2, Windows XP Media Center Edition SP2, or Windows XP Tablet PC Edition SP2.

See Also