IMbnInterface：：ScanNetwork 方法 (mbnapi.h)

重要

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

以異步方式掃描網路以取得可見提供者的清單。

語法

HRESULT ScanNetwork(
  [out] ULONG *requestID
);

[out] requestID

此要求的作業系統所設定之要求標識碼的指標。異步回應將包含這個相同的 requestID。

這個方法可以傳回其中一個值。

傳回碼	描述
S_OK	已成功完成命令。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	行動寬頻服務未在此系統上執行。
E_HANDLE	介面無效。最有可能是因為行動寬頻裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	介面無效。最有可能是因為行動寬頻裝置已從系統中移除。

此方法會起始網路掃描作業。成功完成時，它會填入操作系統的可見提供者快取，而應用程式可以呼叫 IMbnInterface 的 GetVisibleProviders 方法，以取得可見網路清單。

這是耗時的作業。因此，應用程式應該先呼叫 GetVisibleProviders ，而且只有在快取的資訊過時時，才應該呼叫 ScanNetwork 。

這是異步操作， ScanNetwork 會立即傳回。如果此方法傳回成功 (S_OK) ，則當掃描作業完成時，操作系統會呼叫 IMbnInterfaceEvents 的 OnScanNetworkComplete 方法，以通知作業完成的應用程式。

如果在完成此作業之前從系統移除裝置，則不保證應用程式會收到完成通知。