共用方式為

IMbnSms：：SmsSendCdma 方法 (mbnapi.h)

  • 發行項

重要

從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。

以 CDMA 格式傳送訊息。

語法

HRESULT SmsSendCdma(
  [in]  LPCWSTR               address,
  [in]  MBN_SMS_CDMA_ENCODING encoding,
  [in]  MBN_SMS_CDMA_LANG     language,
  [in]  ULONG                 sizeInCharacters,
  [in]  SAFEARRAY             *message,
  [out] ULONG                 *requestID
);

參數

[in] address

包含接收者電話號碼的 Null 終止字串。 字串的大小上限為 15 位數。

[in] encoding

指定資料編碼 的MBN_SMS_CDMA_ENCODING 值。

[in] language

指定語言的MBN_SMS_CDMA_LANG值。

[in] sizeInCharacters

訊息中的編碼字元數目。 這與訊息陣列的大小不同。

[in] message

位元組陣列，包含編碼的 CDMA 訊息。

此陣列的大小上限是IMbnSmsConfiguration的CdmaShortMsgSize屬性，不過這不能大於MBN_CDMA_SHORT_MSG_SIZE_MAX ( 160) 。

[out] requestID

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

傳回值

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

傳回碼 描述
S_OK
 已成功完成命令。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
行動寬頻服務未在此系統上執行。
E_HANDLE
 介面無效，最有可能是因為裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
介面無效。 最有可能是行動寬頻裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
裝置不支援以要求的格式傳送 SMS 訊息。 例如，如果針對 GSM 裝置呼叫此函式。

備註

這個方法可用來傳送 CDMA 裝置的 SMS 訊息。 不過，只有當 CDMA 裝置支援傳送 SMS 時，才會發生這種情況。 呼叫應用程式可以藉由呼叫IMbnInterface的GetInterfaceCapability方法來瞭解裝置是否支援此格式。 然後， 它可以在 MBN_INTERFACE_CAPS 的 smsCaps 成員中尋找 MBN_SMS_CAPS_TEXT_SEND。

位址參數可以是下列其中一種格式。

  • 「+ < 國際國家/地區代碼 >< SMS 服務中心號碼 > \0」
  • 「 < SMS Service Center Number > \0」

這是會立即傳回的非同步作業。 如果方法傳回時沒有錯誤，則行動寬頻服務會呼叫IMbnSmsEvents介面的OnSmsSendComplete方法。

需求

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

另請參閱

IMbnSms