IPortableDeviceContent::Move method (portabledeviceapi.h)

  • Artikel

Metode Pindahkan memindahkan satu atau beberapa objek dari satu lokasi pada perangkat ke lokasi lainnya.

Sintaks

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

Parameter

[in] pObjectIDs

Penunjuk ke antarmuka IPortableDevicePropVariantCollection yang menyimpan satu atau beberapa string yang dihentikan null (jenis VT_LPWSTR) yang menentukan ID objek objek yang akan dipindahkan.

[in] pszDestinationFolderObjectID

Penunjuk ke string yang dihentikan null yang menentukan ID tujuan.

[in, out] ppResults

Opsional. Saat dikembalikan, parameter ini berisi kumpulan nilai VT_ERROR yang menunjukkan keberhasilan atau kegagalan operasi. Elemen pertama yang dikembalikan dalam ppResults sesuai dengan objek pertama dalam koleksi pObjectIDs , elemen kedua yang dikembalikan dalam ppResults sesuai dengan objek kedua dalam koleksi pObjectIDs , dan sebagainya. Parameter ini bisa NULL jika aplikasi tidak peduli dengan hasilnya.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Jika ada nilai kesalahan yang dikembalikan, tidak ada objek yang dihapus pada perangkat.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
S_FALSE
 Satu atau beberapa objek telah dihapus, tetapi setidaknya satu objek tidak dapat dihapus. Lihat ppFailedObjectIDs untuk mempelajari objek mana yang tidak dihapus.
E_ACCESSDENIED
 Aplikasi tidak memiliki hak untuk memindahkan objek.
E_POINTER
 Setidaknya salah satu argumen yang diperlukan adalah penunjuk NULL .

Keterangan

Jika perangkat yang ditentukan mendukung operasi pemindahan pada penyimpanan fungsional, parameter pszDestinationFolderObjectID dapat menentukan pengidentifikasi untuk penyimpanan fungsional.

Contoh

Untuk contoh cara menggunakan metode ini, lihat Memindahkan Konten di Perangkat.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header portabledeviceapi.h
Pustaka PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDeviceContent

Memindahkan Konten pada Perangkat