Méthode IMbnDeviceService ::QueryCommand (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 QUERY au service d’appareil d’un appareil haut débit mobile.
Syntaxe
HRESULT QueryCommand(
[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 s’est produite lors de l’exécution de cette méthode. |
Remarques
QueryCommand 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. La session de commande sur un service d’appareil doit être ouverte avant que l’application puisse appeler QueryCommand.
Le service Haut débit mobile émet une requête QUERY à 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 ne doit pas dépasser les octets MaxCommandSize .
Il s’agit d’une opération asynchrone et QueryCommand retourne immédiatement. À la fin de l’opération, le service Haut débit mobile appelle la méthode OnQueryCommandComplete 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 |