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

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows ランタイム API に置き換えられます。

モバイルブロードバンドデバイスのデバイスサービスに QUERY コントロールコマンドを送信します。

構文

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

[in] commandID

コマンドの識別子。

[in] deviceServiceData

デバイスに渡されるバイト配列。

[out] requestID

この要求を識別するためにモバイルブロードバンドサービスによって割り当てられた一意の要求 ID。

メソッドは、次のいずれかの値を返すことができます。

リターンコード	説明
S_OK	メソッドは正常に完了しました。
E_ACCESSDENIED	このデバイスサービスコマンドは、プロセス特権を呼び出すことは許可されていません。
その他	このメソッドの実行時にエラーが発生しました。

QueryCommand は、ベンダー固有のデバイスサービス機能を実装するために存在します。これは、モバイルブロードバンド API では取り上げられていません。アプリケーションで QueryCommand を呼び出すには、デバイスサービスのコマンドセッションを開く必要があります。

モバイルブロードバンドサービスは、デバイスに QUERY 要求を発行します。 deviceServiceData は、要求に渡されたデータバッファーにバイト単位でコピーされます。このデータバッファーは、MaxCommandSize バイトを超えることはできません。

これは非同期操作であり、 QueryCommand はすぐに返されます。操作が完了すると、モバイルブロードバンドサービスは IMbnDeviceServicesEvents インターフェイスの OnQueryCommandComplete メソッドを呼び出します。