IPortableDevicePropertiesBulkCallback::Metode OnProgress (portabledeviceapi.h)

  • Artikel

Metode OnProgress dipanggil oleh SDK ketika operasi massal yang dimulai oleh IPortableDevicePropertiesBulk::Start telah mengirim data ke perangkat dan menerima beberapa informasi kembali.

Sintaks

HRESULT OnProgress(
  [in] REFGUID                         pContext,
  [in] IPortableDeviceValuesCollection *pResults
);

Parameter

[in] pContext

Pointer ke GUID yang mengidentifikasi operasi mana yang sedang berlangsung. Nilai ini dihasilkan oleh Antrean... metode antarmuka IPortableDevicePropertiesBulk .

[in] pResults

Pointer ke antarmuka IPortableDeviceValuesCollection yang berisi hasil yang diambil dari perangkat. Antarmuka ini akan menampung satu atau beberapa antarmuka IPortableDeviceValues . Masing-masing antarmuka ini akan menyimpan satu properti WPD_OBJECT_ID dengan nilai string (VT_LPSTR) yang menentukan ID objek objek yang berkaitan dengan nilai-nilai ini. Nilai lainnya di setiap antarmuka IPortableDeviceValues bervariasi, tergantung pada operasi massal yang dilaporkan. Untuk metode QueueGetValuesByObjectFormat dan QueueGetValuesByObjectList , metode tersebut akan diambil nilai dari berbagai jenis. Untuk QueueSetValuesByObjectList, nilai tersebut akan VT_ERROR nilai HRESULT untuk setiap kesalahan yang ditemui saat mengatur nilai.

Nilai kembali

Aplikasi harus mengembalikan S_OK, atau kode kesalahan untuk meninggalkan operasi. Semua kode kesalahan ditangani dengan cara yang sama.

Keterangan

Metode ini dapat dipanggil sekali atau beberapa kali, tergantung pada seberapa besar operasinya.

Metode ini tidak selalu mengambil semua properti sekaligus, juga tidak mengembalikan properti dalam urutan tertentu.

Jika metode ini dipanggil beberapa kali, metode ini dapat mengembalikan properti untuk pengidentifikasi objek yang sama setiap kali.

Persyaratan

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

Lihat juga

Antarmuka IPortableDevicePropertiesBulkCallback