IPortableDeviceService::SendCommand-Methode (portabledeviceapi.h)

Artikel
08/25/2023

Die SendCommand-Methode sendet einen WPD-Standardbefehl und seine Parameter an den Dienst.

Syntax

HRESULT SendCommand(
  [in]  const DWORD           dwFlags,
  [in]  IPortableDeviceValues *pParameters,
  [out] IPortableDeviceValues **ppResults
);

Parameter

[in] dwFlags

Wird nicht verwendet.

[in] pParameters

Die IPortableDeviceValues-Schnittstelle , die die Befehlsparameter angibt.

[out] ppResults

Die IPortableDeviceValues-Schnittstelle , die die Befehlsergebnisse angibt.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Jeder andere HRESULT-Wert gibt an, dass der Aufruf fehlgeschlagen ist.

Hinweise

Diese Methode sollte nur verwendet werden, um WPD-Standardbefehle an den Dienst zu senden. Verwenden Sie zum Aufrufen von Dienstmethoden die IPortableDeviceServiceMethods-Schnittstelle .

Diese Methode kann fehlschlagen, obwohl sie S_OK als HRESULT-Wert zurückgibt. Um festzustellen, ob ein Befehl erfolgreich war, sollte eine Anwendung immer die Eigenschaften untersuchen, auf die vom ppResults-Parameter verwiesen wird:

Die WPD_PROPERTY_COMMON_HRESULT-Eigenschaft gibt an, ob der Befehl erfolgreich war.
Wenn der Befehl fehlgeschlagen ist, enthält die eigenschaft WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE treiberspezifische Fehlercodes.

Das Objekt, auf das vom pParameters-Parameter verwiesen wird, muss mindestens diese Eigenschaften angeben:

WPD_PROPERTY_COMMON_COMMAND_CATEGORY, die eine Befehlskategorie enthalten sollte, z. B. den fmtid-Member der WPD_COMMAND_COMMON_RESET_DEVICE-Eigenschaft
WPD_PROPERTY_COMMON_COMMAND_ID, die einen Befehlsbezeichner enthalten sollte, z. B. den pid-Member der WPD_COMMAND_COMMON_RESET_DEVICE-Eigenschaft .

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h

Weitere Informationen

IPortableDeviceService-Schnittstelle