IMbnDeviceService::SetCommand 方法 (mbnapi.h)

重要

从 Windows 10 版本 1803 开始,本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的 Windows 运行时 API。

SET 控制命令发送到移动宽带设备的设备服务。

语法

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

参数

[in] commandID

命令的标识符。

[in] deviceServiceData

传入设备的字节数组。

[out] requestID

由移动宽带服务分配的唯一请求 ID,用于标识此请求。

返回值

方法可以返回以下值之一。

返回代码 说明
S_OK
该方法已成功完成。
E_ACCESSDENIED
不允许使用此设备服务命令调用进程特权。
其他
执行此方法时遇到错误。

注解

SetCommand 用于实现移动宽带 API 中未涵盖的特定于供应商的设备服务功能。 必须先打开设备服务上的命令会话,然后应用程序才能调用 SetCommand

移动宽带服务将向设备发出 SET 请求。 deviceServiceData 将逐字节复制到传入请求的数据缓冲区中。 此数据缓冲区必须小于 MaxCommandSize 字节。

这是一个异步操作, SetCommand 将立即返回。 操作完成后,移动宽带服务将调用 IMbnDeviceServicesEvents 接口的 OnSetCommandComplete 方法。

要求

要求
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 mbnapi.h

另请参阅

IMbnDeviceService