IPortableDeviceWebControl::GetDeviceFromId-Methode (portabledeviceapi.h)

  • Artikel

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

Syntax

HRESULT GetDeviceFromId(
  [in]          BSTR      deviceId,
  [out, retval] IDispatch **ppDevice
);

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.

[out, retval] ppDevice

Enthält einen Zeiger auf die IDispatch-Implementierung für das WPD Automation Device-Objekt .

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");
 
var device = deviceFactory.getDeviceFromId(deviceId);
// Get the first service on the device
var deviceService = device.services[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