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。 可能的值包括 (但不限於) 下表中的這些值。 如果傳回任何錯誤值,則裝置上不會刪除任何物件。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
已刪除一或多個物件,但無法刪除至少一個物件。 請參閱 ppFailedObjectID 以瞭解 哪些物件未遭到刪除。 |
|
應用程式沒有移動物件的許可權。 |
|
至少其中一個必要自變數是 NULL 指標。 |
備註
如果指定的裝置支援在功能記憶體上移動作業, pszDestinationFolderObjectID 參數可能會指定功能記憶體的標識符。
範例
如需如何使用此方法的範例,請參閱 在裝置上移動內容。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | portabledeviceapi.h |
程式庫 | PortableDeviceGUIDs.lib |