IMbnDeviceService::SetCommand メソッド (mbnapi.h)

重要

バージョン 1803 Windows 10以降、このセクションで説明する 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 メソッドを呼び出します。