IMbnInterfaceEvents::OnPreferredProvidersChange method (mbnapi.h)

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

See also

IMbnInterfaceEvents