IMbnMultiCarrier::GetVisibleProviders method

Gets the list of visible providers in the current area for a multi-carrier device minus preferred and registered providers.


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


age [out]

A pointer to the time, in seconds, since the last refresh of the visible provider list for the device.

visibleProviders [out, retval]

Pointer to an array of MBN_PROVIDER2 structures that contains the list of providers for the interface. If this method returns any value other than S_OK, visibleProviders is NULL. When GetVisibleProviders returns S_OK, the calling application must free the allocated memory by calling SafeArrayDestroy.

Return value

This method can return one of these values.

Return codeDescription

The method completed successfully. visibleProviders contains valid values. Based on the age of the information, the calling application can decide to issue a new call to ScanNetwork


The information is not available. An active network scan is in progress. The calling application can get notified when the device capabilities are available by registering for the OnScanNetworkComplete method of IMbnMultiCarrierEvents


Mobile Broadband's cache of the visible network list is invalid. The calling application should call ScanNetwork to populate the cache.


The operation is not supported by the device. This may be returned by devices which do not support multi-carrier.



This method returns the list of currently visible providers. CDMA devices will report only their home provider if any network in their preferred roaming list (PRL) is available.

To avoid frequent network scan operations, Windows maintains a list of recent scan operations and the provider list is returned from the cached list.

An application can call this method to get a list of visible providers upon the completion of ScanNetwork.

This list contains all the currently visible networks available at the user’s location excluding the ones reported by current registered provider and the list of preferred providers. This list contains network entries that users have not subscribed to. This list providers the user with an additional set of network choices they can potentially sign up for.


Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

None supported



See also