共用方式為

IMbnSms：：SmsRead 方法 (mbnapi.h)

  • 發行項

重要

從 Windows 10 1803 版開始，本節所述的 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

MBN_SMS_FORMAT值，指定應該讀取 SMS 訊息的格式。

針對 GSM 裝置，它應該一律 MBN_SMS_FORMAT_PDU。

針對 CDMA 裝置，如果這指定為 MBN_SMS_FORMAT_PDU，則裝置會讀取二進位模式 CDMA 訊息。 如果它指定為 MBN_SMS_FORMAT_TEXT，則裝置會讀取文字模式 CDMA 訊息。 如果裝置不支援指定的格式，它可以傳回錯誤碼。

[out] requestID

行動寬頻服務所發出之要求識別碼的指標，用來識別此要求。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
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