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を返す必要があります。
解説
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 |