IMbnConnectionEvents::OnConnectComplete メソッド (mbnapi.h)

重要

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

接続操作の完了を通知する通知メソッド。

構文

HRESULT OnConnectComplete(
  [in] IMbnConnection *newConnection,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

[in] newConnection

接続操作が完了したデバイスを表す IMbnConnection インターフェイス。

[in] requestID

接続操作を識別するためにモバイルブロードバンドサービスによって割り当てられた要求 ID。

[in] status

完了状態。

呼び出し元のアプリケーションでは、次のいずれかの値が必要です。

値	説明
S_OK	操作に成功しました。
E_MBN_SIM_NOT_INSERTED	デバイスに SIM はありません。
E_MBN_PIN_REQUIRED	操作を完了するには PIN が必要です。
E_MBN_SERVICE_NOT_ACTIVATED	ネットワークサービスサブスクリプションの有効期限が切れています。
E_MBN_PROVIDER_NOT_VISIBLE	プロバイダーは表示されません。これは、手動登録モードにのみ適用されます。
E_MBN_INVALID_ACCESS_STRING	接続文字列が正しくありません。
HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD)	接続プロファイルでを使用する名前またはパスワードが正しくありません。
E_MBN_VOICE_CALL_IN_PROGRESS	アクティブな音声通話が進行中です。
E_MBN_MAX_ACTIVATED_CONTEXTS	モバイルブロードバンドコンテキストは既にアクティブです。モバイルブロードバンドサービスは、現在、複数のアクティブなコンテキストをサポートしていません。
E_MBN_RADIO_POWER_OFF	デバイス無線がオフです。
E_MBN_PACKET_SVC_DETACHED	アクティブな接続パケットサービスは使用できません。
E_MBN_ACTIVE_CONNECTION	デバイスは既にネットワークに接続されています。

このメソッドは 、S_OKを返す必要があります。

アクティブ化コンテキストが確立されると、アプリケーションは IMbnConnection を使用して現在の接続状態を取得できます。

接続操作でエラーが発生すると、アプリケーションは IMbnConnection インターフェイスの GetActivationNetworkError メソッドを呼び出して、ネットワークエラー情報を取得できます。