IMbnInterface：：GetVisibleProviders 方法 (mbnapi.h)

重要

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

取得可見提供者的清單。

語法

HRESULT GetVisibleProviders(
  [out, retval] ULONG     *age,
  [out, retval] SAFEARRAY **visibleProviders
);

[out, retval] age

自裝置上一次重新整理可見提供者清單後，以秒為單位的時間指標。

[out, retval] visibleProviders

包含介面提供者清單之MBN_PROVIDER 結構的陣列指標。如果這個方法傳回 S_OK以外的任何值，則此參數為 Null。否則，完成時，呼叫程式必須藉由呼叫 SafeArrayDestroy釋放配置的記憶體。

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

傳回碼	描述
S_OK	已成功完成命令。 visibleProviders 包含有效值。根據資訊的存留期，呼叫端應用程式可以決定發出新的 ScanNetwork呼叫。
E_PENDING	資訊無法使用。作用中的網路掃描正在進行中。呼叫應用程式可以註冊IMbnInterfaceEvents的OnScanNetworkComplete方法，以在裝置功能可用時收到通知。
E_MBN_INVALID_CACHE	行動寬頻的可見網路清單快取無效。呼叫的應用程式應該呼叫 ScanNetwork 來填入快取。

這個方法會傳回目前可見提供者的清單。如果慣用漫遊清單中有任何網路 (PRL) 可用，CDMA 裝置只會報告其首頁提供者。

為了避免頻繁的網路掃描作業，作業系統會維護最近的掃描工作清單，並從快取清單傳回提供者清單。

應用程式可以在 ScanNetwork完成時呼叫這個方法，以取得可見的提供者清單。