共用方式為

IMbnSmsEvents：：OnSmsReadComplete 方法 (mbnapi.h)

  • 發行項

重要

從 Windows 10 1803 版開始，本節所述的 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，則會重複呼叫 OnSmsReadComplete ，直到沒有更多訊息且 更多Msgs 為 FALSE為止。

[in] requestID

行動寬頻服務指派的要求識別碼，用來識別訊息讀取作業。

[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 裝置，呼叫的應用程式應該在readMsgs中針對IMbnSmsReadMsgPdu介面的每個元素呼叫QueryInterface。

針對 CDMA 裝置，如果 smsFormat是MBN_SMS_FORMAT_TEXT，應用程式應該呼叫 QueryInterface 作為 IMbnSmsReadMsgTextCdma 介面;否則，如果 smsFormat是MBN_SMS_FORMAT_PDU，應用程式應該呼叫 QueryInterface 作為 IMbnSmsReadMsgPdu 介面。

如果讀取要求會產生大量正在讀取的訊息，則可能會重複呼叫 OnSmsReadComplete ，直到 moreMsgs 指出沒有其他要讀取的訊息為止。

需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 mbnapi.h

另請參閱

IMbnSmsEvents