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。 可能的值包括(但并不限于)下表中的项。 如果返回任何错误值,则表示设备上未删除任何对象。

返回代码 说明
S_OK
方法成功。
S_FALSE
已删除一个或多个对象,但至少一个对象无法删除。 请参阅 ppFailedObjectID, 了解哪些对象未删除。
E_ACCESSDENIED
应用程序没有移动对象的权限。
E_POINTER
至少一个必需的参数是 NULL 指针。

注解

如果指定的设备支持对功能存储执行移动操作, 则 pszDestinationFolderObjectID 参数可以指定功能存储的标识符。

示例

有关如何使用此方法的示例,请参阅 在设备上移动内容

要求

要求
目标平台 Windows
标头 portabledeviceapi.h
Library PortableDeviceGUIDs.lib

另请参阅

IPortableDeviceContent 接口

在设备上移动内容