Méthode IPortableDeviceService::SendCommand (portabledeviceapi.h)

Article
08/25/2023

La méthode SendCommand envoie une commande WPD standard et ses paramètres au service.

Syntaxe

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

Paramètres

[in] dwFlags

Non utilisé.

[in] pParameters

Interface IPortableDeviceValues spécifiant les paramètres de commande.

[out] ppResults

Interface IPortableDeviceValues spécifiant les résultats de la commande.

Valeur retournée

Si la méthode réussit, elle retourne S_OK. Toute autre valeur HRESULT indique que l’appel a échoué.

Notes

Cette méthode doit uniquement être utilisée pour envoyer des commandes WPD standard au service. Pour appeler des méthodes de service, utilisez l’interface IPortableDeviceServiceMethods .

Cette méthode peut échouer même si elle retourne S_OK comme valeur HRESULT . Pour déterminer si une commande a réussi, une application doit toujours examiner les propriétés référencées par le paramètre ppResults :

La propriété WPD_PROPERTY_COMMON_HRESULT indique si la commande a réussi.
Si la commande a échoué, la propriété WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE contient des codes d’erreur spécifiques au pilote.

L’objet référencé par le paramètre pParameters doit spécifier au moins ces propriétés :

WPD_PROPERTY_COMMON_COMMAND_CATEGORY, qui doit contenir une catégorie de commande, telle que le membre fmtid de la propriété WPD_COMMAND_COMMON_RESET_DEVICE
WPD_PROPERTY_COMMON_COMMAND_ID, qui doit contenir un identificateur de commande, tel que le membre pid de la propriété WPD_COMMAND_COMMON_RESET_DEVICE .

Spécifications


Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	portabledeviceapi.h

Voir aussi

IPortableDeviceService, interface