IMbnRegistrationEvents::OnRegisterStateChange 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.

Notification method called by the Mobile Broadband service to indicate a change in the device's registration state.

Syntax

HRESULT OnRegisterStateChange(
  [in] IMbnRegistration *newInterface
);

Parameters

[in] newInterface

Pointer to an IMbnRegistration interface that represents the applicable device.

Return value

This method must return S_OK.

Remarks

The OnRegisterStateChange method is called by the Mobile Broadband service to signal a change in the device registration state. It may be called if any of the following changes:

  • There is a change in the registration state of the device. For example, if the device goes from its home network to a roaming network, then the registration state can change from MBN_REGISTER_STATE_HOME to MBN_REGISTER_STATE_ROAMING.
  • There is a change in registered provider ID, name, or roaming text.
  • There is a change in the last reported network error code for a registration operation.
An application can use the passed IMbnRegistration interface to get the updated registration state data.

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

IMbnRegistrationEvents