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 です。

戻り値

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

リターン コード	説明
S_OK	メソッドは正常に完了しました。 subscriberInformation には有効なインターフェイスが含まれています。
E_PENDING	この情報は使用できません。 モバイル ブロードバンド サービスは現在、情報のプローブを行っています。 呼び出し元のアプリケーションは、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

こちらもご覧ください

IMbnInterface