IMbnInterface::GetHomeProvider メソッド (mbnapi.h)

  • [アーティクル]

重要

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

ホーム プロバイダーを取得します。

構文

HRESULT GetHomeProvider(
  [out, retval] MBN_PROVIDER *homeProvider
);

パラメーター

[out, retval] homeProvider

ホーム プロバイダーを表す MBN_PROVIDER 構造体へのポインター。 このメソッドが S_OK 以外の値を返す場合、このパラメーターは NULL です。 完了したら、呼び出し元のアプリケーションで SysFreeString を呼び出して、MBN_PROVIDERの providerID メンバーと providerName メンバーに割り当てられたメモリを解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。 homeProvider には有効な値が含まれています。
E_PENDING
 この情報は使用できません。 モバイル ブロードバンド サービスは現在、ホーム プロバイダーを取得するためのプローブを行っています。 呼び出し元のアプリケーションは、IMbnInterfaceEvents の OnHomeProviderAvailable メソッドに登録することで、ホーム プロバイダーが使用可能になったときに通知を受け取ることができます。
E_MBN_PIN_REQUIRED
 デバイスでは、この操作のために PIN を入力する必要があります。
E_MBN_SIM_NOT_INSERTED
 SIM は挿入されません。
E_MBN_BAD_SIM
 デバイスに無効な SIM が挿入されます。
HRESULT_FROM_WIN32(ERROR_READ_FAULT)
 SIM またはデバイス メモリから読み取ることができません。 たとえば、SIM にはホーム プロバイダー情報がプロビジョニングされていません。

解説

GetHomeProvider は 、デバイスのホーム プロバイダー情報を返します。 返されるMBN_PROVIDER構造体の dataClass フィールドは無視する必要があります。

回復可能なエラー E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED、 およびE_MBN_BAD_SIMの場合、モバイル ブロードバンド サービスは、エラー状態が終わったら、ホーム プロバイダーに対してデバイスに対して再度クエリを実行します。 たとえば、デバイスでこの情報を取得するために PIN を入力する必要がある場合は、 E_MBN_PIN_REQUIREDが返されます。 アプリケーションが PIN を入力してデバイスのロックを解除すると、モバイル ブロードバンド サービスはデバイスからこの情報を取得しようとします。 システムは、IMbnInterfaceEvents の OnHomeProviderAvailable メソッドを呼び出すことによって、新しいクエリの状態に関するアプリケーションを更新します。

IMbnInterfaceEvents の登録済みの OnHomeProviderAvailable メソッドは、ホーム プロバイダー情報が使用可能な場合に呼び出すか、新しいクエリがエラーで完了したときに呼び出すことができます。 この関数が成功を返すと、この情報は変更されません。

要件

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

関連項目

IMbnInterface