IMbnInterfaceEvents interface (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 interface is a notification interface used to handle asynchronous IMbnInterface method calls as well as changes in the device state.

Inheritance

The IMbnInterfaceEvents interface inherits from the IUnknown interface. IMbnInterfaceEvents also has these types of members:

Methods

The IMbnInterfaceEvents interface has these methods.

 
IMbnInterfaceEvents::OnEmergencyModeChange

This notification method is called by the Mobile Broadband service to indicate that the emergency mode has changed.
IMbnInterfaceEvents::OnHomeProviderAvailable

This notification method is called by the Mobile Broadband service to indicate that home provider information for the device is available.
IMbnInterfaceEvents::OnInterfaceCapabilityAvailable

This notification method is called by the Mobile Broadband service to indicate that interface capability information is available.
IMbnInterfaceEvents::OnPreferredProvidersChange

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

This notification method is called by the Mobile Broadband service to indicate a change in an interface's ready state.
IMbnInterfaceEvents::OnScanNetworkComplete

This notification method is called by the Mobile Broadband service to indicate the completion of a network scan.
IMbnInterfaceEvents::OnSetPreferredProvidersComplete

This notification method is called by the Mobile Broadband service to indicate the completion of a SetPreferredProviders operation.
IMbnInterfaceEvents::OnSubscriberInformationChange

This notification method is called by the Mobile Broadband service to indicate that the subscriber information for the device has changed.

Remarks

The following procedure describes how to register for notifications.

  1. Get an IConnectionPointContainer interface by calling QueryInterface on an IMbnInterfaceManager object.
  2. Call FindConnectionPoint on the returned interface and pass IID_IMbnInterfaceEvents to riid.
  3. Call Advise on the returned connection point and pass a pointer to an IUnknown interface on an object that implements IMbnInterfaceEvents to pUnk.
Notifications can be terminated by calling Unadvise on the connection point returned in step 2.

To view some code that registers for COM notifications, see the Client section of the COM Connection Points article.

Requirements

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