Partager via


Sync Attributes

[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 Sync01 through Sync16 attributes are string representations of 32-bit values that Windows Media Player uses when it synchronizes playlists with one of up to 16 portable devices.

Applies To

Remarks

These are read/write attributes. A value of zero indicates that Windows Media Player should not synchronize the playlist with the associated device. A value greater than zero indicates a synchronization priority for the given playlist.

Based on user input, Windows Media Player sets this attribute for each of the playlists in the library. When Windows Media Player attempts to synchronize a playlist with a portable device, it examines each playlist to compare the values for the SyncXX attributes that represent the device partnership. Playlists that have lower SyncXX values receive higher synchronization priority.

For example, the library might contain the following four playlists and respective SyncXX values:

Playlist Name Sync01 Value
GymMusic.WPL 0x0000000D
Relax.WPL 0x00000020
DriveHome.WPL 0x00000001
NoGo.WPL 0x00000000

When Windows Media Player synchronizes the device associated with the attribute, it will synchronize the playlists in the following order:

  1. DriveHome.WPL
  2. GymMusic.WPL
  3. Relax.WPL

To determine whether you can change the value of this attribute, use the Media.isReadOnlyItem method.

Requirements

Requirement Value
Version
Windows Media Player 10 or later

See also

Attribute Reference

Enumerating Synchronization Playlists