IWMPSyncDevice2::setItemInfo method

The setItemInfo method specifies an attribute value for a device.

Syntax


HRESULT setItemInfo(
  [in]  BSTR bstrItemName,
  [in]  BSTR bstrVal
);

Parameters

bstrItemName [in]

BSTR specifying the name of the attribute on which to set the new value. For supported attribute names, see Remarks.

bstrVal [in]

BSTR specifying the new value. For information about supported values, see Remarks.

Return value

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

Return codeDescription
S_OK

The method succeeded or a partnership exists.

 

Remarks

The following table lists the supported attributes.

Attribute Description
AutoSyncDefaultRules

Specifies whether automatic synchronization is done according to default rules or custom rules. A value of "true" specifies default rules, and a value of "false" specifies custom rules.

Use of this attribute is permitted only for devices with which Windows Media Player has a partnership.

Requires Windows Media Player 12.

BackgroundSyncState

Specifies whether Windows Media Player is allowed to perform background operations for the device.

The value can be a string (BSTR) representation of a bitwise combination of one or more of the following flags.

  • 1 Allow background synchronization.
  • 2 Allow background transcoding.

The value can also be one of the following strings.

  • "0" No background operations are allowed.
  • "255" Allow all background operations.

The value of this attribute lasts for the lifetime of Windows Media Player, but is not stored in the Windows Media Player library.

Use of this attribute is permitted only for devices with which Windows Media Player has a partnership.

Requires Windows Media Player 12.

IncludeSkippedFiles

When the user deletes files from the device, Windows Media Player marks those files as skipped and does not include them in future synchronization operations. Setting this attribute instructs Windows Media Player to include skipped files in the next synchronization.

Set the value of this attribute to the empty BSTR.

Use of this attribute is permitted only for devices with which Windows Media Player has a partnership.

Requires Windows Media Player 12.

PercentSpaceReserved

Limits the amount of device storage that Windows Media Player uses for file synchronization by specifying a portion of the storage as reserved. The value is a numeric percentage of total storage on the device represented by a string (BSTR). Supported values range from "0" to "95".

Use of this attribute is permitted only for devices with which Windows Media Player has a partnership.

SyncFilter

Specifies the types of files that will be synchronized during the next synchronization session, and specifies whether content can be acquired from the device during that synchronization session.

The value can be a string (BSTR) representation of a bitwise combination of one or more of the following flags.

  • 1 Synchronize music files.
  • 2 Synchronize video files.
  • 4 Synchronize picture files.
  • 8 Content can be written to the device, but cannot be acquired from the device.

For example, the string "5" specifies that music and picture files will be synchronized.

The value can also be one of the following strings.

  • "0xFF" Apply no filter to the synchronization session. That is, synchronize all types of files and allow content to be both written to the device and acquired from the device.
  • "0x07" Synchronize files of all types.

This attribute affects only the next synchronization session.

Use of this attribute is permitted only for devices with which Windows Media Player has a partnership.

Requires Windows Media Player 12.

SyncOnConnect

Specifies whether Windows Media Player should synchronize the device when the device gets conntected. The value "true" specifies that Windows Media Player should synchronize the device, and the value "false" specifies that Windows Media Player should not synchronize the device.

Use of this attribute is permitted only for devices with which Windows Media Player has a partnership.

Requires Windows Media Player 12.

 

Windows Media Player 10 Mobile: This method is not supported.

Requirements

Version

Windows Media Player 11 or later

Header

Wmp.h

DLL

Wmp.dll

See also

IWMPSyncDevice2 Interface

 

 

Community Additions

ADD
Show:
© 2014 Microsoft