IMbnMultiCarrierEvents::OnPreferredProvidersChange method (mbnapi.h)

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 the completion of a GetPreferredProviders operation and a change in a device's preferred provider list.

Syntax

HRESULT OnPreferredProvidersChange(
  [in] IMbnMultiCarrier *mbnInterface
);

Parameters

[in] mbnInterface

IMbnMultiCarrier

An IMbnMultiCarrier object that represents the Mobile Broadband device GetPreferredProviders operation.

Return value

This method must return S_OK.

Remarks

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 IMbnMultiCarrier object to get the updated list of preferred providers.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header mbnapi.h

See also

IMbnMultiCarrierEvents