次の方法で共有

IMbnConnectionProfileManager::GetConnectionProfiles メソッド (mbnapi.h)

  • [アーティクル]

重要

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

デバイスに関連付けられている接続プロファイルの一覧を取得します。

構文

HRESULT GetConnectionProfiles(
  [in]          IMbnInterface *mbnInterface,
  [out, retval] SAFEARRAY     **connectionProfiles
);

パラメーター

[in] mbnInterface

プロファイル要求が適用されるデバイスを表す IMbnInterface 。 これが NULL の場合、関数はシステムに存在するすべてのプロファイルを返します。

[out, retval] connectionProfiles

デバイスで使用可能なすべての接続プロファイルを表す IMbnConnectionProfile インターフェイスの配列。 このメソッドが S_OK以外のものを返す場合、配列ポインターは NULL です。それ以外の場合、呼び出し元のアプリケーションは SafeArrayDestroy を呼び出して、割り当てられたメモリを最終的に解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_HANDLE
 モバイル ブロードバンド デバイスがシステムから削除されているため、インターフェイスは無効です。
HRESULT_FROM_WIN32(ERROR_NOT_READY)
 デバイスの準備ができていません。 デバイスが MBN_READY_STATE_INITIALIZEDされていないため、サブスクライバー ID を取得できません。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 モバイル ブロードバンド サービスがこのシステムで実行されていません。

解説

この操作が特定のデバイスに対して呼び出されると、デバイスによって現在報告されているのと同じサブスクライバー ID を持つプロファイルの一覧が返されます。 IMbnInterface の GetSubscriberInformation メソッドを使用して、インターフェイスに関連付けられているサブスクライバー ID を取得できます。

接続プロファイルは、デバイスのサブスクライバー ID に関連付けられます。 GSM デバイスの場合、サブスクライバー ID は SIM の国際モバイル サブスクライバー ID (IMSI) です。 CDMA デバイスの場合は、モバイル識別番号 (MIN) 文字列または International Roaming MIN (IRM) 文字列です。

要件

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

関連項目

IMbnConnectionProfileManager