IPortableDeviceWebControl::GetDeviceFromIdAsync-Methode (portabledeviceapi.h)

Instanziiert ein WPD Automation Device-Objekt asynchron für einen bestimmten WPD-Gerätebezeichner.

Syntax

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

Parameter

[in] deviceId

Ein BSTR , der von Plug-and-Play verwendet wird, um ein aktuell verbundenes WPD-Gerät zu identifizieren. Der PnP-Bezeichner (Plug & Play) für ein bestimmtes Gerät kann von der IPortableDeviceManager::GetDevices-Methode in der WPD C++/COM-API abgerufen werden.

Eine Windows Store-App kann den PnP-Bezeichner eines WPD-Geräts mithilfe von Windows.Devices.Portable.ServiceDevice.GetDeviceSelector oder Windows.Devices.Portable.ServiceDevice.GetDeviceSelectorFromServiceId abrufen, um eine Auswahlzeichenfolge abzurufen, die an Windows.Devices.Enumeration.DeviceInformation.FindAllAsync übergeben werden soll. FindAllAsync gibt eine Auflistung von DeviceInformation-Objekten zurück, die die aktuell verbundenen WPD-Geräte darstellen. Die Id-Eigenschaft eines DeviceInformation-Objekts ist der PnP-Bezeichner des Geräts.

[in] pCompletionHandler

Ein Vervollständigungshandler.

[in] pErrorHandler

Ein Fehlerhandler.

Rückgabewert

Zu den möglichen Rückgabecodes gehören die werte in der folgenden Tabelle, sind aber nicht darauf beschränkt.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_ACCESSDENIED	Ein Aufruf dieser Methode außerhalb einer Windows Store-App, die unter Windows 8 ausgeführt wird, gibt diesen Fehlercode zurück.

Hinweise

Hinweis Diese Methode kann nur in Windows Store-Apps verwendet werden.

 

Beispiele

Für WPD-Geräte, die einen MTP-Gerätedienst verwenden, können Sie ein COM Automation-Objekt erstellen, um mit dem Gerät wie folgt zu arbeiten:

 
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];
                // …
            }
       }

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur UWP-Apps]
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h

Weitere Informationen

IPortableDeviceWebControl

Beispiel für den Dienst für tragbare Geräte