Méthode IMbnDeviceService ::SetCommand (mbnapi.h)
Important
À compter de Windows 10 version 1803, les API Win32 décrites dans cette section sont remplacées par les API Windows Runtime dans l’espace de noms Windows.Networking.Connectivity.
Envoie une commande de contrôle SET au service d’appareil d’un appareil haut débit mobile.
Syntaxe
HRESULT SetCommand(
[in] ULONG commandID,
[in] SAFEARRAY *deviceServiceData,
[out] ULONG *requestID
);
Paramètres
[in] commandID
Identificateur de la commande.
[in] deviceServiceData
Tableau d’octets transmis à l’appareil.
[out] requestID
ID de demande unique attribué par le service haut débit mobile pour identifier cette demande.
Valeur retournée
La méthode peut retourner l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. |
|
Cette commande de service d’appareil n’est pas autorisée pour appeler des privilèges de processus. |
|
Une erreur a été rencontrée lors de l’exécution de cette méthode. |
Remarques
SetCommand existe pour implémenter des fonctionnalités de service d’appareil spécifiques au fournisseur qui ne sont pas couvertes par l’API Haut débit mobile. Une session de commande sur un service d’appareil doit être ouverte avant que l’application puisse appeler SetCommand.
Le service haut débit mobile émettra une demande SET à l’appareil. deviceServiceData sera copié octet par octet dans la mémoire tampon de données transmise à la requête. Cette mémoire tampon de données doit être inférieure à maxCommandSize octets.
Il s’agit d’une opération asynchrone et SetCommand retourne immédiatement. Une fois l’opération terminée, le service haut débit mobile appelle la méthode OnSetCommandComplete de l’interface IMbnDeviceServicesEvents .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | mbnapi.h |