IMbnRegistration::GetProviderID メソッド (mbnapi.h)

  • [アーティクル]

重要

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

現在登録されているネットワークのプロバイダー ID を取得します。

構文

HRESULT GetProviderID(
  [out] BSTR *providerID
);

パラメーター

[out] providerID

現在登録されているプロバイダーの ID を含む文字列へのポインター。 最大長は MBN_PROVIDERID_LEN 文字です。 文字列は、メソッドが成功のために S_OK を返す場合にのみ入力されます。 成功した場合、呼び出し元のアプリケーションは SysFreeString を呼び出して、割り当てられたメモリを解放する必要があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 操作に成功しました。
E_PENDING
 プロバイダー ID は使用できません。 モバイル ブロードバンド サービスは現在、デバイスの情報をプローブしています。 プロバイダー ID が使用可能になると、モバイル ブロードバンド サービスは IMbnRegistrationEvents の OnRegisterModeAvailable メソッドを呼び出します。
E_MBN_PIN_REQUIRED
 プロバイダー ID を取得するには、PIN が必要です。
MBN_SIM_NOT_INSERTED
 SIM はデバイスに挿入されません。
E_MBN_BAD_SIM
 デバイスに無効な SIM が挿入されます。

解説

GetProviderID メソッドは、現在登録されているプロバイダーの ID を取得します。 自動ネットワーク選択モードの場合、これはデバイスが現在登録されているネットワークの ID です。 ネットワーク選択モードが手動の場合、このフィールドには、デバイスが登録を試みるネットワークのプロバイダー ID が含まれます。 CDMA デバイスの場合、プロバイダー ID が不明な場合は MBN_CDMA_DEFAULT_PROVIDER_ID に設定されます。

この情報は、モバイル ブロードバンド デバイスが 1 つのネットワークから別のネットワークに移動するときに変更される可能性があります。 これには、ネットワーク登録状態で MBN_REGISTER_STATE_HOME から MBN_REGISTER_STATE_SEARCHING に変更が加わるたびにが含まれます。 これは、ネットワークがプロバイダー間で登録を移動する場合など、登録済みネットワークに変更がある場合にも発生します。 このような変更の後、モバイル ブロードバンド サービスは IMbnRegistrationEvents の OnRegisterStateChange メソッドを呼び出します。 この場合、アプリケーションは GetProviderID を呼び出す必要があります。

回復可能なエラー E_MBN_PIN_REQUIREDの場合、モバイル ブロードバンド サービスは、エラー状態が過ぎたとき (PIN が入力されたときに) デバイスからこの情報のフェッチを再試行します。 その後、モバイル ブロードバンド サービスは IMbnRegistrationEvents の OnPacketServiceStateChange メソッドを呼び出します。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー mbnapi.h

関連項目

IMbnRegistration