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,用于标识此请求。
返回值
方法可以返回以下值之一。
返回代码 | 说明 |
---|---|
|
该方法已成功完成。 |
|
不允许使用此设备服务命令调用进程特权。 |
|
执行此方法时遇到错误。 |
注解
SetCommand 用于实现移动宽带 API 中未涵盖的特定于供应商的设备服务功能。 必须先打开设备服务上的命令会话,然后应用程序才能调用 SetCommand。
移动宽带服务将向设备发出 SET 请求。 deviceServiceData 将逐字节复制到传入请求的数据缓冲区中。 此数据缓冲区必须小于 MaxCommandSize 字节。
这是一个异步操作, SetCommand 将立即返回。 操作完成后,移动宽带服务将调用 IMbnDeviceServicesEvents 接口的 OnSetCommandComplete 方法。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [桌面应用 |UWP 应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | mbnapi.h |