Metode IPortableDeviceContent::D elete (portabledeviceapi.h)

  • Artikel

Metode Hapus menghapus satu atau beberapa objek dari perangkat.

Sintaks

HRESULT Delete(
  [in]      const DWORD                          dwOptions,
  [in]      IPortableDevicePropVariantCollection *pObjectIDs,
  [in, out] IPortableDevicePropVariantCollection **ppResults
);

Parameter

[in] dwOptions

Salah satu enumerator DELETE_OBJECT_OPTIONS .

[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 dihapus.

[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
 Setidaknya satu objek tidak dapat dihapus. Parameter ppResults , jika ditentukan, berisi kode kesalahan per objek.
E_XXXXXXXX
 Pengandar tidak menghapus objek apa pun.
E_INVALIDARG
 Nilai yang tidak valid ditentukan untuk dwOptions.
E_ACCESSDENIED
 Aplikasi tidak memiliki izin untuk menghapus objek.
HRESULT_FROM_WIN32(ERROR_DIR_NOT_EMPTY)
 Folder atau direktori yang ditentukan tidak dapat dihapus karena tidak kosong.
HRESULT_FROM_WIN32(ERROR_INVALID_OPERATION)
 Aplikasi yang ditentukan PORTABLE_DEVICE_DELETE_NO_RECURSION, dan objek memiliki turunan.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 Objek tidak dapat dihapus karena tidak ada pada perangkat.

Keterangan

Untuk melihat apakah penghapusan rekursif didukung, panggil IPortableDeviceCapabilities::GetCommandOptions. Jika antarmuka IPortableDeviceValues yang diambil berisi nilai properti yang disebut WPD_OPTION_OBJECT_MANAGEMENT_RECURSIVE_DELETE_SUPPORTED dengan nilai boolVal True, perangkat mendukung penghapusan rekursif.

Tabel berikut mencantumkan kemungkinan kode pengembalian yang mungkin muncul dalam koleksi tempat ppResults menunjuk.

Contoh

Untuk contoh cara menggunakan metode ini, lihat Menghapus Konten dari Perangkat.

Persyaratan

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

Lihat juga

Menghapus Konten dari Perangkat

Antarmuka IPortableDeviceContent