Метод IMbnDeviceService::WriteData (mbnapi.h)

Важно!

Начиная с Windows 10 версии 1803, API Win32, описанные в этом разделе, заменяются среда выполнения Windows API в пространстве имен Windows.Networking.Connectivity.

Запись данных в сеанс данных службы устройства.

Синтаксис

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

Параметры

[in] deviceServiceData

Массив байтов, передаваемый на устройство для записи.

[out] requestID

Уникальный идентификатор запроса, назначенный службой мобильной широкополосной связи для идентификации этого запроса.

Возвращаемое значение

Метод может возвращать одно из следующих значений.

Код возврата	Описание
S_OK	Метод завершился успешно.
E_ACCESSDENIED	Эта команда службы устройства не разрешена для вызова привилегий процесса.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)	Длина deviceServiceData больше поддерживаемого параметра MaxDataSize.
HRESULT_FROM_WIN32(ERROR_OPEN_FAILED)	Сеанс службы устройства не открыт.
Другое	При выполнении этого метода возникла ошибка.

Комментарии

WriteData передает массовые данные в службу устройства конкретного поставщика на устройстве. Служба мобильной широкополосной связи перенаправит этот запрос на устройство. deviceServiceData будет скопирован по байтам в буфер данных, передаваемый в запрос. Этот буфер данных должен быть меньше MaxDataSize байт.

Сеанс данных должен быть открыт, прежде чем приложение сможет вызвать WriteData. Операционная система не предоставляет гарантий задержки или производительности WriteData.

Это асинхронная операция, и WriteData возвращается немедленно. По завершении операции служба мобильной широкополосной связи вызовет метод OnWriteDataComplete интерфейса IMbnDeviceServicesEvents .

Требования

Целевая платформа	Windows
Header	mbnapi.h

См. также раздел

IMbnDeviceService