共用方式為


IPortableDeviceContent::Move 方法 (portabledeviceapi.h)

Move 方法會將一或多個物件從裝置上的某個位置移至另一個位置。

語法

HRESULT Move(
  [in]      IPortableDevicePropVariantCollection *pObjectIDs,
  [in]      LPCWSTR                              pszDestinationFolderObjectID,
  [in, out] IPortableDevicePropVariantCollection **ppResults
);

參數

[in] pObjectIDs

IPortableDevicePropVariantCollection 介面的指標,該介面會保存一或多個以 Null 結尾的字串, (類型VT_LPWSTR) 指定要移动之对象的对象标识符。

[in] pszDestinationFolderObjectID

指定目的地標識碼之 Null 終止字串的指標。

[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
程式庫 PortableDeviceGUIDs.lib

另請參閱

IPortableDeviceContent 介面

移動裝置上的內容