Método IMbnDeviceService::SetCommand (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 set de control al servicio de dispositivo de un dispositivo de banda ancha móvil.

Sintaxis

HRESULT SetCommand(
  [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

SetCommand existe para implementar la funcionalidad de servicio de dispositivo específica del proveedor que no se trata en la API de banda ancha móvil. Se debe abrir una sesión de comandos en un servicio de dispositivo para que la aplicación pueda llamar a SetCommand.

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

Se trata de una operación asincrónica y SetCommand se devolverá inmediatamente. Al finalizar la operación, el servicio de banda ancha móvil llamará al método OnSetCommandComplete 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