IMbnRegistrationEvents::OnRegisterStateChange メソッド (mbnapi.h)

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows ランタイム API に置き換えられます。

デバイスの登録状態の変更を示すために、モバイルブロードバンドサービスによって呼び出される通知メソッド。

構文

HRESULT OnRegisterStateChange(
  [in] IMbnRegistration *newInterface
);

[in] newInterface

該当するデバイスを表す IMbnRegistration インターフェイスへのポインター。

このメソッドは 、S_OKを返す必要があります。

OnRegisterStateChange メソッドは、デバイス登録状態の変更を通知するために、モバイルブロードバンドサービスによって呼び出されます。次のいずれかの変更が発生した場合に呼び出される場合があります。

デバイスの登録状態に変更があります。たとえば、デバイスがホームネットワークからローミングネットワークに移動する場合、登録の状態は MBN_REGISTER_STATE_HOME から MBN_REGISTER_STATE_ROAMING に変わる可能性があります。
登録済みプロバイダー ID、名前、またはローミングテキストに変更があります。
登録操作の最後に報告されたネットワークエラーコードに変更があります。

アプリケーションは、渡された IMbnRegistration インターフェイスを使用して、更新された登録状態データを取得できます。