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 |