Método IMbnDeviceService::QueryCommand (mbnapi.h)

Importante

A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.

Envía un comando de control QUERY al servicio de dispositivo de un dispositivo de banda ancha móvil.

Sintaxis

HRESULT QueryCommand(
  [in]  ULONG     commandID,
  [in]  SAFEARRAY *deviceServiceData,
  [out] ULONG     *requestID
);

Parámetros

[in] commandID

Identificador del comando.

[in] deviceServiceData

Matriz de bytes que se pasa al dispositivo.

[out] requestID

Identificador de solicitud único asignado por el servicio de banda ancha móvil para identificar esta solicitud.

Valor devuelto

El método puede devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_ACCESSDENIED	Este comando de servicio de dispositivo no se permite para llamar a privilegios de proceso.
Otros	Se encontró un error al ejecutar este método.

Comentarios

QueryCommand existe para implementar la funcionalidad de servicio de dispositivo específica del proveedor, que no se trata de otro modo en mobile Broadband API. La sesión de comandos de un servicio de dispositivo debe abrirse antes de que la aplicación pueda llamar a QueryCommand.

El servicio de banda ancha móvil emitirá una solicitud QUERY al dispositivo. deviceServiceData se copiará byte-byte en el búfer de datos pasado a la solicitud. Este búfer de datos no debe ser superior a MaxCommandSize bytes.

Se trata de una operación asincrónica y QueryCommand se devolverá inmediatamente. Al finalizar la operación, el servicio de banda ancha móvil llamará al método OnQueryCommandComplete de la interfaz IMbnDeviceServicesEvents .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	mbnapi.h

Consulte también

IMbnDeviceService