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

  • [アーティクル]

重要

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

デバイスの現在の接続状態を取得します。

構文

HRESULT GetConnectionState(
  [out, retval] MBN_ACTIVATION_STATE *ConnectionState,
  [out, retval] BSTR                 *ProfileName
);

パラメーター

[out, retval] ConnectionState

接続の状態を含む MBN_ACTIVATION_STATE 構造体へのポインター。

[out, retval] ProfileName

接続プロファイルの名前を含む文字列へのポインター。 このパラメーターは、 ConnectionState が MBN_ACTIVATION_STATE_ACTIVATEDされている場合にのみ有効です。 この文字列が NULL でない場合、呼び出し元のアプリケーションは SysFreeString を呼び出してこの文字列を解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
メモ このメソッドは、 ProfileName が NULL の場合にS_OKを返すことができます。 呼び出しが成功した場合でも、クライアントが NULLProfileName を処理できることを確認します。
 
E_PENDING
 アクティブ化の状態は使用できません。 モバイル ブロードバンド サービスは、デバイスの情報をプローブしています。 呼び出し元のアプリケーションは、IMbnConnectionEvents の OnConnectStateChange メソッドに登録することで、アクティブ化状態が使用可能になったときに通知を受け取ることができます。
E_MBN_PIN_REQUIRED
 呼び出し状態を取得するには、PIN が必要です。
E_MBN_SIM_NOT_INSERTED
 SIM はデバイスに挿入されません。
E_MBN_BAD_SIM
 デバイスに無効な SIM が挿入されます。

解説

ProfileName が NULL の場合、このメソッドはS_OKを返すことができます。 呼び出しが成功した場合でも、クライアントが NULLProfileName を処理できることを確認します。

要件

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

関連項目

IMbnConnection