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

  • [アーティクル]

重要

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

デバイスの音声通話状態を取得します。

構文

HRESULT GetVoiceCallState(
  [out, retval] MBN_VOICE_CALL_STATE *voiceCallState
);

パラメーター

[out, retval] voiceCallState

音声通話の状態を指定する MBN_VOICE_CALL_STATE 値へのポインター。 メソッドが S_OK以外のものを返す場合、このポインターの内容は設定されません。

戻り値

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

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

解説

回復可能なエラー E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED、 およびE_MBN_BAD_SIMの場合、モバイル ブロードバンド サービスは、エラー状態が終了すると、この情報についてデバイスに再度クエリを実行します。 たとえば、デバイスで音声通話の状態を取得するために PIN を入力する必要がある場合は、 E_MBN_PIN_REQUIRED が返されます。 呼び出し元のアプリケーションが PIN に入ってデバイスのロックを解除した後、モバイル ブロードバンド サービスはデバイスから音声通話の状態を取得しようとします。 モバイル ブロードバンド サービスは、IMbnConnectionEvents の OnVoiceCallStateChange メソッドを呼び出すことによって、新しいプローブの状態でアプリケーションを更新します。

要件

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

関連項目

IMbnConnection