WPD_COMMAND_OBJECT_MANAGEMENT_MOVE_OBJECTS command
Moves specified objects to the specified destination folder on the device. This operation is typically used on devices that support it for moving content without affecting play count or use count or related properties of the file.
Move operations can be done on folders. In general, after the move operation, objects must have the same Object ID and PUID as before the move. If for any reason, the Object ID and PUID have to change, the driver is required to send WPD_EVENT_OBJECT_REMOVED events with the old IDs, and WPD_EVENT_OBJECT_ADDED events for the new IDs.
To indicate progress, the driver should send a series of WPD_EVENT_OBJECT_MOVE events, indicating the appropriate operation state updates.
Command category
WPD_CATEGORY_OBJECT_MANAGEMENT
Parameters
Parameters |
---|
The driver expects the following parameters. |
WPD_PROPERTY_OBJECT_MANAGEMENT_OBJECT_IDS |
WPD_PROPERTY_OBJECT_MANAGEMENT_DESTINATION_FOLDER_OBJECT_ID |
Return value
Result |
---|
The driver should return the following results. |
WPD_PROPERTY_OBJECT_MANAGEMENT_MOVE_RESULTS |
WPD_PROPERTY_COMMON_HRESULT |
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE |
Calling methods
- IStream::Revert
- IPortableDeviceDataStream::Revert (inherited from IStream)
Requirements
Version |
Commands |
Header |
PortableDevice.h |
See also