IMbnSmsEvents::OnSmsReadComplete メソッド (mbnapi.h)

  • [アーティクル]

重要

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

メッセージ読み取り操作の完了を示す通知メソッド。

構文

HRESULT OnSmsReadComplete(
  [in] IMbnSms        *sms,
  [in] MBN_SMS_FORMAT smsFormat,
  [in] SAFEARRAY      *readMsgs,
  [in] VARIANT_BOOL   moreMsgs,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

パラメーター

[in] sms

操作を完了したメッセージ ストアを表す IMbnSms インターフェイス。

[in] smsFormat

SMS メッセージの形式を定義する MBN_SMS_FORMAT 値。

[in] readMsgs

デバイスから読み取られたメッセージの配列。

[in] moreMsgs

まだ処理中のメッセージが他にあるかどうかを示すブール値。 TRUE の場合、メッセージが増えず、moreMsgs が FALSE になるまで、OnSmsReadComplete が繰り返し呼び出されます。

[in] requestID

メッセージの読み取り操作を識別するためにモバイル ブロードバンド サービスによって割り当てられた要求 ID。

[in] status

操作の結果を示す状態コード。

呼び出し元のアプリケーションでは、次のいずれかの値が必要です。

値 説明
S_OK
 操作に成功しました。
E_MBN_SIM_NOT_INSERTED
 デバイスに SIM はありません。
E_MBN_BAD_SIM
 デバイスに不適切な SIM があります。
E_MBN_PIN_REQUIRED
 操作を完了するには PIN が必要です。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 SMS 操作または特定の SMS 形式は、デバイスでサポートされていません。
E_MBN_SMS_MEMORY_FAILURE
 SMS メモリエラー。
E_MBN_SMS_INVALID_MEMORY_INDEX
 要求された値を持つメモリ インデックスはありません。
E_MBN_SMS_FILTER_NOT_SUPPORTED
 デバイスは、要求されたフィルターをサポートしていません。

戻り値

このメソッドは 、S_OKを返す必要があります。

解説

GSM デバイスの場合、呼び出し元のアプリケーションは、iMbnSmsReadMsgPdu インターフェイスの readMsgs 内の各要素で QueryInterface を呼び出す必要があります。

CDMA デバイスの場合、smsFormat がMBN_SMS_FORMAT_TEXT場合、アプリケーションは IMbnSmsReadMsgTextCdma インターフェイスに対して QueryInterface を呼び出す必要があります。それ以外の場合、smsFormat がMBN_SMS_FORMAT_PDU場合、アプリケーションは IMbnSmsReadMsgPdu インターフェイスに対して QueryInterface を呼び出す必要があります。

読み取り要求で大量のメッセージが読み取られる場合は、moreMsgs が読み取るメッセージがなくなったことを示すまで、OnSmsReadComplete が繰り返し呼び出されることがあります。

要件

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

関連項目

IMbnSmsEvents