IMbnInterfaceEvents::OnSetPreferredProvidersComplete method (mbnapi.h)

Article
10/13/2021

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 SetPreferredProviders operation.

Syntax

HRESULT OnSetPreferredProvidersComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

Parameters

[in] newInterface

An IMbnInterface that represents a device on which this operation was performed.

[in] requestID

The request ID assigned by the Mobile Broadband service for this asynchronous operation.

[in] status

The operation completion status.

The following table lists the valid values for this status.

Value	Meaning
S_OK	The operation was successful.
E_MBN_PIN_REQUIRED	The device requires a PIN to be entered for this operation to complete.
E_MBN_SIM_NOT_INSERTED	The SIM is not inserted.
E_MBN_BAD_SIM	A bad SIM is inserted in the device.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	The device does not support this operation.

Return value

This method must return S_OK.

Remarks

If the operation completed successfully, that is, when status is S_OK, then the application can call the GetPreferredProviders method of the passed IMbnInterface to get an updated list of preferred providers.

If multiple applications registered for notifications, then this method will be called on all registered applications. This means that an application that did not initiate the update operation will also receive a notification.

If a call to the SetPreferredProviders method of IMbnInterface results in a change in the preferred provider list, then the OnPreferredProvidersChange method of IMbnInterfaceEvents 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