IMbnMultiCarrierEvents：：OnScanNetworkComplete 方法 (mbnapi.h)

重要

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

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

語法

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

[in] mbnInterface

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

[in] requestID

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

[in] status

狀態碼，指出 ScanNetwork的結果。

值	意義
S_OK	作業成功。
E_MBN_RADIO_POWER_OFF	無法取得可見的網路清單，因為裝置無線電已關閉。當應用程式收到無線電開啟通知時，可能會發出網路掃描要求。
E_MBN_DEVICE_BUSY	裝置忙碌中，目前無法執行網路掃描作業。這是由建立資料連線時不支援網路掃描作業的裝置所傳回。
E_MBN_ALREADY_ACTIVE	網路掃描作業正在進行中。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	裝置不支援此作業。這可由不支援多電信業者之裝置傳回。

這個方法必須傳回 S_OK。

如果狀態S_OK，行動寬頻服務已成功更新可見提供者的快取清單。然後，應用程式可以呼叫傳遞之 IMbnMultiCarrier的GetVisibleProviders方法，以取得可見提供者的清單。

如果有多個應用程式已註冊通知，則會在所有已註冊的應用程式上呼叫此方法。這表示未起始更新作業的應用程式會收到通知。