IMbnSignalEvents::OnSignalStateChange 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 that a signal quality update is available.

Syntax

HRESULT OnSignalStateChange(
  [in] IMbnSignal *newInterface
);

Parameters

[in] newInterface

Pointer to an IMbnSignal interface for which the signal quality update was received.

Return value

This method must return S_OK.

Remarks

OnSignalStateChange is called by the Mobile Broadband service to notify a calling application that a signal quality update is available. This includes an update of the signal notification period, threshold for signal notification, signal strength received, and error rate in the received signal. An application can get updated values from the IMbnSignal interface passed in this method.

Requirements

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