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 |