Metode IPortableDeviceWebControl::GetDeviceFromIdAsync (portabledeviceapi.h)

  • Artikel

Membuat instans objek Perangkat Automasi WPD secara asinkron untuk pengidentifikasi perangkat WPD tertentu.

Sintaks

HRESULT GetDeviceFromIdAsync(
  [in] BSTR      deviceId,
  [in] IDispatch *pCompletionHandler,
  [in] IDispatch *pErrorHandler
);

Parameter

[in] deviceId

BSTR yang digunakan oleh Plug-and-play untuk mengidentifikasi perangkat WPD yang saat ini terhubung. Pengidentifikasi Plug and Play (PnP) untuk perangkat tertentu dapat diperoleh dari metode IPortableDeviceManager::GetDevices di API WPD C++/COM.

Aplikasi Windows Store dapat memperoleh pengidentifikasi PnP perangkat WPD dengan menggunakan Windows.Devices.Portable.ServiceDevice.GetDeviceSelector atau Windows.Devices.Portable.ServiceDevice.GetDeviceSelectorFromServiceId untuk mendapatkan string pemilih untuk diteruskan ke Windows.Devices.Enumeration.DeviceInformation.FindAllAsync. FindAllAsync mengembalikan kumpulan objek DeviceInformation yang mewakili perangkat WPD yang saat ini terhubung. Properti Id objek DeviceInformation adalah pengidentifikasi PnP perangkat.

[in] pCompletionHandler

Handler penyelesaian.

[in] pErrorHandler

Penangan kesalahan.

Nilai kembali

Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
E_ACCESSDENIED
 Panggilan ke metode ini di luar aplikasi Windows Store yang berjalan di Windows 8 akan mengembalikan kode galat ini.

Keterangan

Catatan Metode ini hanya dapat digunakan di aplikasi Bursa Windows.
 

Contoh

Untuk perangkat WPD yang menggunakan layanan perangkat MTP, Anda dapat membuat objek COM Automation untuk bekerja dengan perangkat seperti ini:


 
deviceFactory = new ActiveXObject("PortableDeviceAutomation.Factory");
 
// Get the first device object from the device factory
        deviceFactory.getDeviceFromIdAsync(deviceInfoElement.id,
            function (device) {
                // Get the first service on the device
                var deviceService = device.services[0];
                // Get the first storage on the device
                var deviceStorage = devices.storages[0];
                // …
            }
       }

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [hanya aplikasi UWP]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi UWP]
Target Platform Windows
Header portabledeviceapi.h

Lihat juga

IPortableDeviceWebControl

Sampel Layanan Perangkat Portabel