IMbnInterfaceEvents：：OnScanNetworkComplete 方法 (mbnapi.h)

重要

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

行動寬頻服務會呼叫此通知方法，以指出網路掃描完成。

語法

HRESULT OnScanNetworkComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

[in] newInterface

IMbnInterface，代表執行此作業的裝置。

[in] requestID

此通知的行動寬頻服務指派的要求識別碼。

[in] status

作業完成狀態

呼叫的應用程式可以預期下列其中一個值。

S_OK

作業成功。

E_MBN_RADIO_POWER_OFF

無法取得可見的網路清單，因為裝置無線電已關閉。當應用程式收到無線電開啟通知時，可能會發出網路掃描要求。

E_MBN_DEVICE_BUSY

裝置忙碌中，目前無法執行網路掃描作業。這是由建立資料連線時不支援網路掃描作業的裝置所傳回。

E_MBN_ALREADY_ACTIVE

網路掃描作業正在進行中。

這個方法必須傳回 S_OK。

如果作業成功完成，也就是 當狀態 S_OK時，行動寬頻服務已成功更新可見提供者的快取清單。然後，應用程式可以呼叫傳遞IMbnInterface的GetVisibleProviders方法，以取得可見提供者的清單。

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