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

Importante

A partir do Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.

Gravar dados em uma sessão de dados do serviço de dispositivo.

Sintaxe

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

Parâmetros

[in] deviceServiceData

Uma matriz de bytes que é passada para o dispositivo a ser gravado.

[out] requestID

Uma ID de solicitação exclusiva atribuída pelo serviço de Banda Larga Móvel para identificar essa solicitação.

Valor retornado

O método pode retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_ACCESSDENIED	Este comando de serviço de dispositivo não é permitido para chamar privilégios de processo.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)	O comprimento do deviceServiceData é maior que o MaxDataSize com suporte.
HRESULT_FROM_WIN32(ERROR_OPEN_FAILED)	A sessão de serviço do dispositivo não está aberta.
Outros	Um erro foi encontrado ao executar esse método.

Comentários

WriteData passa dados em massa para um serviço de dispositivo específico do fornecedor no dispositivo. O serviço de Banda Larga Móvel encaminhará essa solicitação para o dispositivo. deviceServiceData será copiado byte por byte no buffer de dados passado para a solicitação. Esse buffer de dados deve ser menor que MaxDataSize bytes.

A sessão de dados deve ser aberta antes que o aplicativo possa chamar WriteData. O sistema operacional não fornece garantias sobre a latência ou o desempenho de WriteData.

Essa é uma operação assíncrona e WriteData retornará imediatamente. Após a conclusão da operação, o serviço de Banda Larga Móvel chamará o método OnWriteDataComplete da interface IMbnDeviceServicesEvents .

Requisitos

Plataforma de Destino	Windows
Cabeçalho	mbnapi.h

Confira também

IMbnDeviceService