Metode IPortableDeviceProperties::D elete (portabledeviceapi.h)

  • Artikel

Metode Hapus menghapus properti tertentu dari objek tertentu pada perangkat.

Sintaks

HRESULT Delete(
  [in] LPCWSTR                      pszObjectID,
  [in] IPortableDeviceKeyCollection *pKeys
);

Parameter

[in] pszObjectID

Penunjuk ke string yang dihentikan null yang menentukan ID objek yang propertinya akan Anda hapus. Untuk menentukan perangkat, gunakan WPD_DEVICE_OBJECT_ID.

[in] pKeys

Penunjuk ke antarmuka IPortableDeviceKeyCollection yang menentukan properti mana yang akan dihapus. Untuk daftar properti yang ditentukan oleh Perangkat Portabel Windows, lihat Properti dan Atribut.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
S_FALSE
 Satu atau beberapa nilai properti tidak dapat dihapus.
E_POINTER
 Argumen pointer yang diperlukan adalah NULL.

Keterangan

Properti hanya dapat dihapus jika atribut WPD_PROPERTY_ATTRIBUTE_CAN_DELETE-nya True. Atribut ini dapat diambil dengan memanggil GetPropertyAttributes.

Pengemudi tidak memiliki cara untuk menunjukkan keberhasilan parsial; artinya, jika hanya beberapa properti yang dapat dihapus, driver akan mengembalikan S_FALSE, tetapi metode ini tidak menunjukkan properti mana yang berhasil dihapus. Satu-satunya cara untuk mempelajari properti mana yang dihapus adalah dengan meminta semua properti dengan memanggil IPortableDeviceProperties::GetValues.

Persyaratan

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

Lihat juga

Antarmuka IPortableDeviceProperties