IMbnInterface::GetSubscriberInformation メソッド (mbnapi.h)
重要
バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows ランタイム API に置き換えられます。
サブスクライバー情報を取得します。
構文
HRESULT GetSubscriberInformation(
[out, retval] IMbnSubscriberInformation **subscriberInformation
);
パラメーター
[out, retval] subscriberInformation
デバイスのサブスクライバー情報を含む IMbnSubscriberInformation インターフェイスのアドレスへのポインター。 このメソッドが S_OK 以外の値を返す場合、このパラメーターは NULL です。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
メソッドは正常に完了しました。 subscriberInformation には有効なインターフェイスが含まれています。 |
|
この情報は使用できません。 モバイル ブロードバンド サービスは現在、情報のプローブを行っています。 呼び出し元のアプリケーションは、IMbnInterfaceEvents の OnSubscriberInformationChange メソッドに登録することで、情報が利用可能になったときに通知を受け取ることができます。 |
注釈
GetSubscriberInformation メソッドは、サブスクライバー ID、SIM 国際回線カード番号、このインターフェイスに関連付けられている電話番号など、サブスクライバー関連の情報を返します。
このメソッドが携帯電話会社の特権を持つ Windows ストア アプリから呼び出されると、SimIccID プロパティによって定義された SIM International 回線カード番号のみが返されます。
サブスクライバー情報で返される値の一部は、IMbnInterface の GetReadyState メソッドによって報告された準備完了状態がMBN_READY_STATE_INITIALIZED場合にのみ設定されます。 モバイル ブロードバンド デバイスに関連付けられているサブスクライバー情報に変更がある場合、モバイル ブロードバンド サービスは、IMbnInterfaceEvents の OnSubscriberInformationChange メソッドを呼び出すことによって、登録済みアプリケーションに通知します。
デバイスの準備状態が MBN_READY_STATE_INITIALIZEDされると、デバイスのサブスクライバー情報は変更されません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | mbnapi.h |