IMbnMultiCarrier：：SetHomeProvider 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。
更新多電信業者裝置的主提供者。
語法
HRESULT SetHomeProvider(
[in] MBN_PROVIDER2 *homeProvider,
[out] ULONG *requestID
);
參數
[in] homeProvider
包含主提供者 的MBN_PROVIDER2 結構。
注意
SignalStrength和SignalError成員必須是 0。
[out] requestID
此要求的作業系統所設定之要求識別碼的指標。 OnSetHomeProviderComplete的非同步回應將包含這個相同的requestID。
此要求的作業系統所設定之要求識別碼的指標。 非同步回應將包含這個相同的 requestID。
傳回值
這個方法可以傳回其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 |
|
行動寬頻服務未在此系統上執行。 |
|
不正確介面。 行動寬頻裝置可能已從系統中移除。 |
|
不正確介面。 最有可能是行動寬頻裝置已從系統中移除。 |
|
裝置不支援此作業。 這可由不支援多電信業者之裝置傳回。 |
備註
SetHomeProvider方法會起始介面的主提供者更新。 這是非同步作業，而方法呼叫會立即傳回。 如果此方法成功傳回S_OK，則 Windows 會藉由呼叫IMbnMultiCarrierEvents的OnSetHomeProviderComplete方法，通知呼叫呼叫端應用程式此作業的完成狀態。
裝置接著會自動向新的網路註冊，並指出註冊狀態變更。 除非 再次使用 SetHomeProvider 來設定新的家用提供者，否則裝置會繼續跨 Windows 重新開機向這個新的家用網路註冊。
如果裝置在完成此作業之前從系統移除，則不保證呼叫端應用程式會收到完成通知。
需求
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | mbnapi.h |