IMbnDeviceService::SetCommand-Methode (mbnapi.h)

Sendet einen SET-Steuerelementbefehl an den Gerätedienst eines mobilen Breitbandgeräts.

Syntax

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

Parameter

[in] commandID

Ein Bezeichner für den Befehl.

[in] deviceServiceData

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

[out] requestID

Eine eindeutige Anforderungs-ID, die vom Mobile Broadband-Dienst zugewiesen wird, um diese Anforderung zu identifizieren.

Rückgabewert

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

Hinweise

SetCommand ist vorhanden, um anbieterspezifische Gerätedienstfunktionen zu implementieren, die in der mobilen Breitband-API sonst nicht behandelt werden. Eine Befehlssitzung für einen Gerätedienst muss geöffnet werden, bevor die Anwendung SetCommand aufrufen kann.

Der mobile Breitbanddienst stellt eine SET-Anforderung an das Gerät aus. deviceServiceData wird byte-by-byte in den Datenpuffer kopiert, der an die Anforderung übergeben wird. Dieser Datenpuffer muss kleiner als MaxCommandSize-Bytes sein.

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

Anforderungen

Weitere Informationen

IMbnDeviceService