IMbnDeviceService::SetCommand-Methode (mbnapi.h)
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.
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.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Dieser Gerätedienstbefehl ist für das Aufrufen von Prozessberechtigungen nicht zulässig. |
|
Beim Ausführen dieser Methode ist ein Fehler aufgetreten. |
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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |