次の方法で共有


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 の場合、メッセージが増えず、moreMsgsFALSE になるまで、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 デバイスの場合、smsFormatMBN_SMS_FORMAT_TEXT場合、アプリケーションは IMbnSmsReadMsgTextCdma インターフェイスに対して QueryInterface を呼び出す必要があります。それ以外の場合、smsFormatMBN_SMS_FORMAT_PDU場合、アプリケーションは IMbnSmsReadMsgPdu インターフェイスに対して QueryInterface を呼び出す必要があります。

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

要件

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

関連項目

IMbnSmsEvents