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 メンバーに割り当てられたメモリを解放する必要があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
メソッドは正常に完了しました。 homeProvider には有効な値が含まれています。 |
|
この情報は使用できません。 モバイル ブロードバンド サービスは現在、ホーム プロバイダーを取得するためのプローブを行っています。 呼び出し元のアプリケーションは、IMbnInterfaceEvents の OnHomeProviderAvailable メソッドに登録することで、ホーム プロバイダーが使用可能になったときに通知を受け取ることができます。 |
|
デバイスでは、この操作のために PIN を入力する必要があります。 |
|
SIM は挿入されません。 |
|
デバイスに無効な SIM が挿入されます。 |
|
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 |