Metode IPortableDeviceContent::GetObjectIDsFromPersistentUniqueIDs (portabledeviceapi.h)

  • Artikel

Metode GetObjectIDsFromPersistentUniqueIDs mengambil ID objek saat ini dari satu atau beberapa objek, mengingat ID unik persisten (PUID) mereka.

Sintaks

HRESULT GetObjectIDsFromPersistentUniqueIDs(
  [in]  IPortableDevicePropVariantCollection *pPersistentUniqueIDs,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

Parameter

[in] pPersistentUniqueIDs

Penunjuk ke antarmuka IPortableDevicePropVariantCollection yang berisi satu atau beberapa nilai string ID unik persisten (PUID) (ketik VT_LPWSTR).

[out] ppObjectIDs

Penunjuk ke penunjuk antarmuka IPortableDevicePropVariantCollection yang berisi ID objek yang diambil, sebagai jenis VT_LPWSTR. ID yang diambil akan berada dalam urutan yang sama dengan PUID yang dikirimkan; jika nilai tidak dapat ditemukan, nilai tersebut ditunjukkan oleh string kosong. Pemanggil harus merilis antarmuka ini ketika selesai dengannya.

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.
E_POINTER
 Setidaknya salah satu argumen yang diperlukan adalah penunjuk NULL .

Keterangan

ID Objek Perangkat Portabel Windows unik di seluruh perangkat, tetapi mungkin berbeda di seluruh sesi. ID Objek dapat berubah ketika aplikasi terhubung kembali ke perangkat.

Aplikasi tertentu, seperti mesin sinkronisasi, memerlukan cara untuk mengidentifikasi objek di seluruh sesi koneksi. Setiap objek memiliki properti WPD_OBJECT_PERSISTENT_UNIQUE_ID, yang menunjukkan pengidentifikasi yang persisten di seluruh sesi. Aplikasi dapat membaca dan menyimpan properti ini dalam sesi awalnya, dengan memanggil metode Properti .

Contoh

Untuk contoh cara menggunakan metode ini, lihat Mengambil Pengidentifikasi Objek dari Pengidentifikasi Unik Persisten

Persyaratan

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

Lihat juga

Antarmuka IPortableDeviceContent

Mengambil Pengidentifikasi Objek dari Pengidentifikasi Unik Persisten