Edit

IMbnInterfaceEvents::OnPreferredProvidersChange method (mbnapi.h)

  • Article

Important

Starting in Windows 10, version 1803, the Win32 APIs described in this section are replaced by the Windows Runtime APIs in the Windows.Networking.Connectivity namespace.

This notification method is called by the Mobile Broadband service to indicate a change in a device's preferred provider list.

Syntax

HRESULT OnPreferredProvidersChange(
  [in] IMbnInterface *newInterface
);

Parameters

[in] newInterface

An IMbnInterface that represents the Mobile Broadband device whose preferred provider list has changed.

Return value

This method must return S_OK.

Remarks

In some cases, a device's preferred provider list can be updated by the network by SMS or OTA (over The air) update. The Mobile Broadband service will call this method to notify the application about any change in the preferred provider list. The application can call the GetPreferredProviders method of the passed IMbnInterface to get the updated list of preferred providers.

If there is a change in the preferred provider list because of a call to the SetPreferredProviders method of IMbnInterface, then this notification will not be called.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server None supported
Target Platform Windows
Header mbnapi.h

See also

IMbnInterfaceEvents