Edit

Share via

IMbnInterfaceEvents::OnSetPreferredProvidersComplete 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 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

See also

IMbnInterfaceEvents