IMbnRegistrationEvents::OnRegisterStateChange method

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

newInterface [in]

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

See also

IMbnRegistrationEvents