共用方式為

IMbnSms：：SetSmsConfiguration 方法 (mbnapi.h)

  • 發行項

重要

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

匯報 裝置的SMS設定。

語法

HRESULT SetSmsConfiguration(
  [in]  IMbnSmsConfiguration *smsConfiguration,
  [out] ULONG                *requestID
);

參數

[in] smsConfiguration

IMbnSmsConfiguration 介面，代表用來更新裝置的新 SMS 組態。

[out] requestID

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

傳回值

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

傳回碼 描述
S_OK
 已成功完成命令。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
行動寬頻服務未在系統上執行。
E_HANDLE
 介面無效，很可能是因為裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
介面無效。 很可能已從系統移除行動寬頻裝置。

備註

應用程式可以使用 SetSmsConfiguration 來修改裝置中的預設 SMS 服務中心位址。

應用程式應該執行下列步驟來設定裝置的SMS組態。

  1. 呼叫 GetSmsConfiguration 以取得 IMbnSmsConfiguration介面。
  2. 使用反映組態所需變更的新值，修改從步驟 1 取得的 IMbnSmsConfiguration 介面。
  3. 將修改過的 IMbnSmsConfiguration 傳遞至 SetSmsConfiguration。
這是會立即傳回的異步操作。 如果方法傳回時沒有錯誤，則行動寬頻服務會呼叫IMbnSmsEvents 介面的 OnSetSmsConfigurationComplete 方法。

規格需求

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

另請參閱

IMbnSms

IMbnSmsConfiguration