phoneGetStatus 関数 (tapi.h)

  • [アーティクル]

phoneGetStatus 関数を使用すると、アプリケーションは、指定した開いている電話デバイスの全体的な状態を照会できます。

構文

LONG phoneGetStatus(
  HPHONE        hPhone,
  LPPHONESTATUS lpPhoneStatus
);

パラメーター

hPhone

クエリを実行する開いている電話デバイスを処理します。

lpPhoneStatus

PHONESTATUS 型の可変サイズのデータ構造へのポインター。電話の状態に関する返された情報が読み込まれます。

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_OPERATIONFAILED、PHONEERR_STRUCTURETOOSMALL、PHONEERR_OPERATIONUNAVAIL、PHONEERR_UNINITIALIZED。

注釈

アプリケーションでは、この関数を使用して、開いている電話デバイスの現在の状態を判断できます。 状態情報は、電話デバイスのフックスイッチ デバイス、呼び出し音、音量、ディスプレイ、ランプに関する情報を記述します。

要件

要件 値
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

こちらもご覧ください

PHONESTATUS

補助電話サービス機能

TAPI 2.2 リファレンスの概要