次の方法で共有


phoneSetStatusMessages 関数 (tapi.h)

phoneSetStatusMessages 関数を使用すると、アプリケーションは、指定した電話デバイスで選択した状態イベントを監視できます。

構文

LONG phoneSetStatusMessages(
  HPHONE hPhone,
  DWORD  dwPhoneStates,
  DWORD  dwButtonModes,
  DWORD  dwButtonStates
);

パラメーター

hPhone

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

dwPhoneStates

アプリケーションが通知メッセージを受信できる電話の状態の変更とイベントのセット。 このパラメーターには、0 個、1 つ以上の PHONESTATE_定数を指定できます。

dwButtonModes

アプリケーションが通知メッセージを受信できる電話ボタン モードのセット。 このパラメーターには、0 個、1 つ以上の PHONEBUTTONMODE_定数を指定できます。

dwButtonStates

アプリケーションが通知メッセージを受信できる電話ボタンの状態変更のセット。 dwButtonModes パラメーターが 0 の場合、dwButtonStates は無視されます。 dwButtonModes に 1 つ以上のビットが設定されている場合、このパラメーターには少なくとも 1 つのビットが設定されている必要があります。 このパラメーターは 、PHONEBUTTONSTATE_定数を使用します

戻り値

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

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPHONESTATE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALBUTTONMODE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALBUTTONSTATE、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONUNAVAIL。

解説

アプリケーションでは 、phoneSetStatusMessages 関数を使用して、対応するメッセージの生成を有効または無効にすることができます。 既定では、すべての電話ステータス メッセージが無効になっています。

要件

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

関連項目

PHONECAPS

PHONE_CLOSE

PHONE_STATE

補助電話サービス機能

TAPI 2.2 リファレンスの概要

phoneGetDevCaps

phoneInitialize

phoneInitializeEx

phoneOpen