phoneGetButtonInfoW 関数 (tapi.h)

phoneGetButtonInfo 関数は、指定したボタンに関する情報を返します。

構文

LONG phoneGetButtonInfoW(
  HPHONE            hPhone,
  DWORD             dwButtonLampID,
  LPPHONEBUTTONINFO lpButtonInfo
);

パラメーター

hPhone

開いている電話デバイスへのハンドル。

dwButtonLampID

電話デバイスのボタン。

lpButtonInfo

PHONEBUTTONINFO型の可変サイズの構造体へのポインター。 このデータ構造は、モードと関数を記述し、ボタンに対応する追加の説明テキストを提供します。

戻り値

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

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

備考

手記

tapi.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして phoneGetButtonInfo を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	tapi.h
ライブラリ	Tapi32.lib
DLL	Tapi32.dll

関連項目

PHONEBUTTONINFO を する

補足電話サービス機能

TAPI 2.2 リファレンスの概要