IMbnDeviceService::WriteData-Methode (mbnapi.h)

Artikel
08/24/2023

Wichtig

Ab Windows 10 Version 1803 werden die in diesem Abschnitt beschriebenen Win32-APIs durch die Windows-Runtime-APIs im Windows.Networking.Connectivity-Namespace ersetzt.

Schreiben von Daten in eine Gerätedienstdatensitzung.

Syntax

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

Parameter

[in] deviceServiceData

Ein Bytearray, das zum Schreiben an das Gerät übergeben wird.

[out] requestID

Eine eindeutige Anforderungs-ID, die vom Mobilen Breitbanddienst zugewiesen wird, um diese Anforderung zu identifizieren.

Rückgabewert

Die -Methode kann einen der folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_ACCESSDENIED	Dieser Gerätedienstbefehl ist für das Aufrufen von Prozessberechtigungen nicht zulässig.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)	Die Länge von deviceServiceData ist größer als die unterstützte MaxDataSize.
HRESULT_FROM_WIN32(ERROR_OPEN_FAILED)	Die Gerätedienstsitzung ist nicht geöffnet.
Andere	Beim Ausführen dieser Methode ist ein Fehler aufgetreten.

Hinweise

WriteData übergibt massenweise Daten an einen anbieterspezifischen Gerätedienst auf dem Gerät. Der mobile Breitbanddienst leitet diese Anforderung an das Gerät weiter. deviceServiceData wird byte-byte in den Datenpuffer kopiert, der an die Anforderung übergeben wird. Dieser Datenpuffer muss kleiner als MaxDataSize-Bytes sein.

Die Datensitzung muss geöffnet werden, bevor die Anwendung WriteData aufrufen kann. Das Betriebssystem bietet keine Garantien für die Latenz oder Leistung von WriteData.

Dies ist ein asynchroner Vorgang, und WriteData wird sofort zurückgegeben. Nach Abschluss des Vorgangs ruft der Mobile Broadband-Dienst die OnWriteDataComplete-Methode der IMbnDeviceServicesEvents-Schnittstelle auf .

Requirements (Anforderungen)


Zielplattform	Windows
Kopfzeile	mbnapi.h

Weitere Informationen

IMbnDeviceService

Freigeben über