IMbnConnection::Connect メソッド (mbnapi.h)

  • [アーティクル]

重要

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

データ接続を確立します。

構文

HRESULT Connect(
  [in]  MBN_CONNECTION_MODE connectionMode,
  [in]  LPCWSTR             strProfile,
  [out] ULONG               *requestID
);

パラメーター

[in] connectionMode

接続のモードを指定する MBN_CONNECTION_MODE 値。

[in] strProfile

プロファイル指定子を含みます。

[out] requestID

この非同期要求を識別するためにモバイル ブロードバンド サービスによって返される一意の要求 ID へのポインター。

戻り値

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

リターン コード 説明
S_OK
 操作に成功しました。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 モバイル ブロードバンド サービスがこのシステムで実行されていません。
E_HANDLE
 インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスがシステムから削除されています。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスがシステムから削除されています。
E_INVALIDARG
 無効なプロファイル名が指定されているか 、strProfile 引数が XML プロファイル スキーマに準拠していません
E_MBN_MAX_ACTIVATED_CONTEXTS
 アクティブなモバイル ブロードバンド コンテキストが既にあります。 複数のアクティブなコンテキストはサポートされていません。

解説

Connect メソッドは、デバイスの接続コンテキストをアクティブ化するために使用されます。 モバイル ブロードバンド サービスは現在、最大 1 つのアクティブ なコンテキストをサポートしています。 コンテキストをアクティブ化すると、L2 接続も確立されます。 同様に、コンテキストを非アクティブ化すると、モバイル ネットワークへの物理データ接続が切断されます。

この操作の呼び出し時にデバイスがパケット接続状態でない場合、モバイル ブロードバンド サービスは、デバイスに接続要求を発行する前に、デバイスを暗黙的にパケット接続します。 パケット サービスの状態が変更された場合、アプリケーションは IMbnRegistrationEvents インターフェイスの OnPacketServiceStateChange メソッドの呼び出しによって通知されます。

connectionMode が MBN_CONNECTION_MODE_PROFILE に設定されている場合、strProfile はデバイスのプロファイルの名前を表します。 MBN_CONNECTION_MODE_TMP_PROFILEに設定すると、strProfile はプロファイルの XML 表現を表します。 呼び出し元のアプリケーションでは、 IMbnConnectionProfileManager を使用して、デバイスに格納されている接続プロファイルの一覧を取得できます。

これは、すぐに返される非同期操作です。 このメソッドが正常に返された場合、モバイル ブロードバンド サービスは、操作の完了時に IMbnConnectionEvents の OnConnectComplete メソッドを呼び出します。

Windows 8 以降のバージョンの Windows: Windows ストア アプリでは、MBN_CONNECTION_MODE_TMP_PROFILEconnectionMode と strProfile パラメーターのみがプロファイルの XML 表現に設定された Connect を使用できます。 これは、接続が一時的な性質であり、システムによって将来使用するために保存されないことを意味します。

要件

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

関連項目

IMbnConnection