IMbnMultiCarrier：：GetVisibleProviders 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始，本節所述的 Win32 API 會由 Windows.Networking.Connectivity 命名空間中的 Windows 執行階段 API 取代。
取得多電信業者裝置目前區域中可見提供者的清單，減去慣用和已註冊的提供者。
語法
HRESULT GetVisibleProviders(
[out] ULONG *age,
[out, retval] SAFEARRAY **visibleProviders
);
參數
[out] age
自裝置上一次重新整理可見提供者清單以來的時間指標，以秒為單位。
[out, retval] visibleProviders
包含介面提供者清單 之MBN_PROVIDER2 結構的陣列指標。 如果這個方法傳回 S_OK以外的任何值， 則visibleProviders 為 NULL。 當 GetVisibleProviders 傳回 S_OK時，呼叫端應用程式必須呼叫 SafeArrayDestroy 來釋放配置的記憶體。
傳回值
這個方法可以傳回其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 visibleProviders 包含有效值。 根據資訊年齡，呼叫端應用程式可以決定發出新的 ScanNetwork 呼叫 |
|
信息無法使用。 作用中的網路掃描正在進行中。 呼叫端應用程式可以在裝置功能可用時收到通知，方法是註冊IMbnMultiCarrierEvents的 OnScanNetworkComplete 方法 |
|
行動寬頻的可見網路清單快取無效。 呼叫的應用程式應該呼叫 ScanNetwork 以填入快取。 |
|
裝置不支援此作業。 這可由不支援多電信業者之裝置傳回。 |
備註
這個方法會傳回目前可見提供者的清單。 CDMA 裝置只有在有可用的慣用漫遊清單中有任何網路 (PRL) 時，才會報告其首頁提供者。
為了避免頻繁的網路掃描作業，Windows 會維護最近的掃描作業清單，並從快取清單傳回提供者清單。
應用程式可以在 ScanNetwork 完成時呼叫這個方法，以取得可見提供者的清單。
此清單包含使用者位置上所有目前可見的網路，不包括目前已註冊提供者所回報的網路，以及慣用提供者的清單。 此清單包含使用者未訂閱的網路專案。 此清單會向使用者提供一組可能註冊的額外網路選項。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | mbnapi.h |