IMbnMultiCarrierEvents：：OnSetHomeProviderComplete 方法 (mbnapi.h)

重要

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

行動寬頻服務會呼叫此通知方法，以指出 SetHomeProvider 作業完成。

語法

HRESULT OnSetHomeProviderComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

[in] mbnInterface

代表行動寬頻裝置 SetHomeProvider 作業的 IMbnMultiCarrier 物件。

[in] requestID

行動寬頻服務指派給 SetHomeProvider 作業的要求標識碼。

[in] status

指出 SetHomeProvider 結果的狀態代碼。

值	意義
S_OK	作業成功。
E_MBN_PROVIDER_NOT_VISIBLE	無法看見要求的提供者。
E_INVALIDARG	無效的註冊模式輸入，提供作為輸入的提供者標識碼超過長度上限 7 個字元，或提供的數據類別無效。在輸入中提供無效的自變數時，行動寬頻服務不會將要求傳送至裝置。在手動註冊模式中，這表示要求的提供者已禁止。
E_FAIL	無法完成作業。如需詳細資訊，請參閱網路錯誤碼。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	裝置不支援此作業。這可能由不支援多載廠商的裝置傳回。

這個方法必須 傳回S_OK。

如果 status 為 S_OK，則 SetHomeProvider 已成功將介面的主提供者設定為新的提供者。否則，原始的主提供者不會變更，而且介面的先前狀態，例如連線、封包服務等，會保持不變。