IPortableDeviceContent::Move 方法 (portabledeviceapi.h)
Move 方法将一个或多个对象从设备上的一个位置移到另一个位置。
语法
HRESULT Move(
[in] IPortableDevicePropVariantCollection *pObjectIDs,
[in] LPCWSTR pszDestinationFolderObjectID,
[in, out] IPortableDevicePropVariantCollection **ppResults
);
参数
[in] pObjectIDs
指向 IPortableDevicePropVariantCollection 接口的指针,该接口保存一个或多个以 null 结尾的字符串 (类型VT_LPWSTR) 指定要移动的对象的对象 ID。
[in] pszDestinationFolderObjectID
指向以 null 结尾的字符串的指针,该字符串指定目标 ID。
[in, out] ppResults
可选。 返回时,此参数包含指示操作成功或失败的VT_ERROR值的集合。 在 ppResults 中返回的第一个元素对应于 pObjectIDs 集合中的第一个对象,ppResults 中返回的第二个元素对应于 pObjectIDs 集合中的第二个对象,依此而论。 如果应用程序不关注结果,此参数可以为 NULL 。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。 如果返回任何错误值,则表示设备上未删除任何对象。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
已删除一个或多个对象,但至少一个对象无法删除。 请参阅 ppFailedObjectID, 了解哪些对象未删除。 |
|
应用程序没有移动对象的权限。 |
|
至少一个必需的参数是 NULL 指针。 |
注解
如果指定的设备支持对功能存储执行移动操作, 则 pszDestinationFolderObjectID 参数可以指定功能存储的标识符。
示例
有关如何使用此方法的示例,请参阅 在设备上移动内容。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |