次の方法で共有

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

  • [アーティクル]

重要

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

特定のモバイル ブロードバンド デバイスに関連付けられている特定の接続プロファイルを取得します。

構文

HRESULT GetConnectionProfile(
  [in]          IMbnInterface         *mbnInterface,
  [in]          LPCWSTR               profileName,
  [out, retval] IMbnConnectionProfile **connectionProfile
);

パラメーター

[in] mbnInterface

プロファイル要求が適用されるデバイスを表す IMbnInterface 。 mbnInterface が NULL の場合、この関数はシステム内の任意のデバイスに関連付けられている指定された名前のプロファイルを返します。

[in] profileName

接続プロファイルの名前を含む null で終わる文字列。

[out, retval] connectionProfile

目的の接続プロファイルを表す IMbnConnectionProfile インターフェイス。 このメソッドが S_OK以外のものを返す場合、これは NULL です。

戻り値

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

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

注釈

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

CreateConnectionProfile を使用して新しいプロファイルが作成された場合、呼び出し元は OnConnectionProfileArrival イベントが受信されるまで待ってから、新しいプロファイルの名前で GetConnectionProfile を呼び出す必要があります。そうしないと、GetConnectionProfile API 呼び出しが HRESULT_FROM_WIN32(ERROR_NOT_FOUND) で失敗する可能性があります。

要件

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

こちらもご覧ください

IMbnConnectionProfileManager