IPortableDeviceDispatchFactory::GetDeviceDispatch-Methode (portabledeviceapi.h)

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

Syntax

HRESULT GetDeviceDispatch(
  [in]  LPCWSTR   pszPnPDeviceID,
  [out] IDispatch **ppDeviceDispatch
);

Parameter

[in] pszPnPDeviceID

Ein Zeiger auf eine Zeichenfolge , die 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 über die IPortableDeviceManager::GetDevices-Methode in der WPD-C++/COM-API abgerufen werden.

[out] ppDeviceDispatch

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 unter anderem die in der folgenden Tabelle aufgeführten Werte.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.

Hinweise

Ein Beispiel für die Verwendung der GetDeviceDispatch-Methode zum Instanziieren eines WPD Automation Device-Objekts finden Sie unter Instanziieren der WPD Automation Factory-Schnittstelle.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h
Bibliothek	PortableDeviceGuids.lib

Weitere Informationen

Device-Objekt

IPortableDeviceDispatchFactory-Schnittstelle

Instanziieren der WPD Automation Factory-Schnittstelle