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

行動寬頻服務指派的唯一要求標識符，用來識別此要求。

方法可以傳回下列其中一個值。

SetCommand 存在以實作廠商特定的裝置服務功能，但行動寬頻 API 中未涵蓋此功能。必須先開啟裝置服務上的命令會話，應用程式才能呼叫 SetCommand。

行動寬頻服務會對裝置發出 SET 要求。 deviceServiceData 將會以位元組位元組方式複製到傳入要求的數據緩衝區。此數據緩衝區必須小於 MaxCommandSize 位元組。

這是異步操作， SetCommand 會立即傳回。作業完成時，行動寬頻服務會呼叫 IMbnDeviceServicesEvents 介面的 OnSetCommandComplete 方法。