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

  • [アーティクル]

重要

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

デバイス サービス データ セッションにデータを書き込みます。

構文

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

パラメーター

[in] deviceServiceData

書き込むデバイスに渡されるバイト配列。

[out] requestID

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

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_ACCESSDENIED
 このデバイス サービス コマンドは、プロセス特権を呼び出すことは許可されていません。
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
 deviceServiceData の長さが、サポートされている MaxDataSize を超えています。
HRESULT_FROM_WIN32(ERROR_OPEN_FAILED)
 デバイス サービス セッションが開いていません。
その他
 このメソッドの実行時にエラーが発生しました。

解説

WriteData は、デバイス上のベンダー固有のデバイス サービスに一括データを渡します。 モバイル ブロードバンド サービスは、この要求をデバイスに転送します。 deviceServiceData は、要求に渡されたデータ バッファーにバイト単位でコピーされます。 このデータ バッファーは 、MaxDataSize バイト未満である必要があります。

アプリケーションで WriteData を呼び出す前に、データ セッションを開く必要があります。 オペレーティング システムでは、 WriteData の待機時間またはパフォーマンスが保証されません。

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

必要条件

   
対象プラットフォーム Windows
ヘッダー mbnapi.h

関連項目

IMbnDeviceService