Freigeben über


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