IMbnSms::SmsRead メソッド (mbnapi.h)

  • [アーティクル]

重要

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

デバイスから SMS メッセージのセットを読み取ります。

構文

HRESULT SmsRead(
  [in]  MBN_SMS_FILTER *smsFilter,
  [in]  MBN_SMS_FORMAT smsFormat,
  [out] ULONG          *requestID
);

パラメーター

[in] smsFilter

読み取るメッセージのセットを定義する MBN_SMS_FILTER 構造体へのポインター。

[in] smsFormat

SMS メッセージを読 み取る形式を指定するMBN_SMS_FORMAT値。

GSM デバイスの場合は、常に MBN_SMS_FORMAT_PDUする必要があります。

CDMA デバイスの場合、これが MBN_SMS_FORMAT_PDU として指定されている場合、デバイスはバイナリ モードの CDMA メッセージを読み取ります。 MBN_SMS_FORMAT_TEXTとして指定されている場合、デバイスはテキスト モードの CDMA メッセージを読み取ります。 デバイスが指定された形式をサポートしていない場合は、エラー コードを返すことができます。

[out] requestID

この要求を識別するためにモバイル ブロードバンド サービスによって発行された要求 ID へのポインター。

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 モバイル ブロードバンド サービスがこのシステムで実行されていません。
E_HANDLE
 インターフェイスが無効です。ほとんどの場合、デバイスがシステムから削除されたためです。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスはシステムから削除されています。
E_INVALIDARG
 smsFormat または smsFilter が無効です。

解説

smsFilter を使用すると、新しいメッセージ、下書きメッセージ、インデックスを使用した特定のメッセージなどの基本的なフィルターをアプリケーションで指定できます。 複雑なフィルターは、基本的なフィルターの組み合わせを統合することによって使用できます。 すべてのインターフェイスは、インデックス ベースのフィルターと新しいメッセージの種類のフィルターをサポートしています。 一部のインターフェイスでは、他のフィルターのサポートは省略可能です。 指定したフィルターがサポートされていない場合、操作完了コールバック関数は E_MBN_STATUS_FILTER_NOT_SUPPORTEDの状態を返します。

これは、すぐに返される非同期操作です。 メソッドがエラーなしで返された場合、モバイル ブロードバンド サービスは IMbnSmsEvents インターフェイスの OnSmsReadComplete メソッドを呼び出します。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー mbnapi.h

関連項目

IMbnSms