IMbnMultiCarrier::ScanNetwork 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始,本節所述的 Win32 API 會由 Windows.Networking.Connectivity 命名空間中的 Windows 執行階段 API 取代。
掃描網路以取得多電信業者裝置的可見提供者清單。
語法
HRESULT ScanNetwork(
[out] ULONG *requestID
);
參數
[out] requestID
此要求的作業系統所設定之要求標識碼的指標。 來自 OnScanNetworkComplete 的異步回應將包含這個相同的 requestID。
傳回值
這個方法可以傳回其中一個值。
傳回碼 | 描述 |
---|---|
|
已成功完成命令。 |
|
行動寬頻服務未在此系統上執行。 |
|
介面無效。 最有可能是因為行動寬頻裝置已從系統中移除。 |
|
介面無效。 最有可能是因為行動寬頻裝置已從系統中移除。 |
|
裝置不支援此作業。 這可由不支援多電信業者之裝置傳回。 |
備註
此方法會起始網路掃描作業。 成功完成時,它會填入操作系統的可見提供者快取,而應用程式可以呼叫 IMbnMultiCarrier 的 GetVisibleProviders 方法,以取得可見網路的清單。
這是耗時的作業。 因此,應用程式應該先呼叫 GetVisibleProviders ,而且只有在快取的資訊過時時,才應該呼叫 ScanNetwork 。
這是異步操作, ScanNetwork 會立即傳回。 如果這個方法傳回成功 (S_OK) ,則完成掃描作業時,操作系統會呼叫 IMbnMultiCarrierEvents 的 OnScanNetworkComplete 方法,以通知作業完成的應用程式。
如果在完成此作業之前從系統移除裝置,則不保證應用程式會收到完成通知。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | mbnapi.h |