IPortableDeviceManager::GetDevices method (portabledeviceapi.h)

Mengambil daftar perangkat portabel yang tersambung ke komputer.

Sintaks

HRESULT GetDevices(
  [in, out] LPWSTR *pPnPDeviceIDs,
  [in, out] DWORD  *pcPnPDeviceIDs
);

Parameter

[in, out] pPnPDeviceIDs

Array penunjuk string yang dialokasikan penelepon yang menyimpan nama Plug and Play dari semua perangkat yang terhubung. Untuk mempelajari ukuran yang diperlukan untuk parameter ini, pertama-tama panggil metode ini dengan parameter ini diatur ke NULL dan pcPnPDeviceID diatur ke nol, lalu alokasikan buffer sesuai dengan nilai yang diambil oleh pcPnPDeviceIDs. Nama-nama ini dapat digunakan oleh IPortableDevice::Open untuk membuat koneksi ke perangkat.

[in, out] pcPnPDeviceIDs

Pada input, jumlah nilai yang dapat dipegang oleh pPnPDeviceIDs . Pada output, pointer ke jumlah perangkat yang benar-benar ditulis ke pPnPDeviceIDs.

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 .
S_FALSE	Buffer pPnPDeviceIDs terlalu kecil untuk menahan semua nilai yang diminta, tetapi nilai pcPnPDeviceIDs telah ditulis ke pPnPDeviceIDs.

Keterangan

Daftar perangkat dihasilkan ketika manajer perangkat dibuat; tidak disegarkan saat perangkat tersambung dan terputus. Untuk merefresh daftar perangkat yang tersambung, panggil RefreshDeviceList.

API mengalokasikan memori untuk setiap string yang diarahkan oleh array pPnPDeviceIDs . Setelah aplikasi Anda tidak lagi membutuhkan string ini, aplikasi harus melakukan iterasi melalui array ini dan membebaskan memori terkait dengan memanggil fungsi CoTaskMemFree .

Contoh

Untuk contoh cara menggunakan metode ini untuk menghitung perangkat, lihat Menghitung Perangkat. Untuk contoh cara menggunakan metode ini untuk menghitung Layanan, lihat Menghitung Layanan.

Persyaratan

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

Lihat juga

Menghitung Perangkat

Menghitung Layanan

Antarmuka IPortableDeviceManager