Compartir a través de

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

  • Artículo

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.

Escribir datos en una sesión de datos del servicio de dispositivos.

Sintaxis

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

Parámetros

[in] deviceServiceData

Matriz de bytes que se pasa al dispositivo para escribir.

[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 está permitido para llamar a privilegios de proceso.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
 La longitud de deviceServiceData es mayor que maxDataSize compatible.
HRESULT_FROM_WIN32(ERROR_OPEN_FAILED)
 La sesión del servicio de dispositivo no está abierta.
Otros
 Se encontró un error al ejecutar este método.

Comentarios

WriteData pasa datos masivos a un servicio de dispositivo específico del proveedor en el dispositivo. El servicio de banda ancha móvil reenviará esta solicitud 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 maxDataSize bytes.

La sesión de datos debe abrirse antes de que la aplicación pueda llamar a WriteData. El sistema operativo no proporciona garantías sobre la latencia o el rendimiento de WriteData.

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

Requisitos

   
Plataforma de destino Windows
Encabezado mbnapi.h

Consulte también

IMbnDeviceService