Windows Media Player 11 SDK About Partnerships
.gif)
| Previous | Next |
About Partnerships
A partnership is a special relationship between a portable device and Windows Media Player. Users can establish a partnership for a particular device by using the Windows Media Player user interface. You can programmatically manage partnerships by using IWMPSyncDevice::createPartnership and IWMPSyncDevice::deletePartnership. The createPartnership method starts an asynchronous process that ends when the CreatePartnershipComplete event is received through the IWMPEvents2 interface.
Windows Media Player 10 or later supports creating partnerships with up to 16 devices. Each partnership has an associated partnership index. You can retrieve the partnership index for a particular device by calling IWMPSyncDevice::get_partnershipIndex. Partnership indices are numbered from 1 to 16. When a particular device does not have a partnership with Windows Media Player, getPartnershipIndex returns zero for the index.
You can retrieve the partnership status of a particular device by calling IWMPSyncDevice::get_status and then inspecting the WMPDeviceStatus value retrieved. Windows Media Player allows one partnership with one user's library on one computer for each device. This means that creating a new partnership destroys any existing partnership the current device might have with another computer. To know when the status changes for a device, you can receive the DeviceStatusChange event.
Windows Media Player cannot create a partnership with a device having the status wmpdsManualDevice.
See Also
| Previous | Next |