phoneGetStatusMessages 関数 (tapi.h)
phoneGetStatusMessages 関数は、指定された電話デバイスで、アプリケーションへのコールバックを生成する電話状態の変更を返します。
構文
LONG phoneGetStatusMessages(
HPHONE hPhone,
LPDWORD lpdwPhoneStates,
LPDWORD lpdwButtonModes,
LPDWORD lpdwButtonStates
);
パラメーター
hPhone
監視対象の開いている電話デバイスへのハンドル。
lpdwPhoneStates
PHONESTATE_定数の 0 個以上を保持する DWORD へのポインター。 これらのフラグは、アプリケーションが通知メッセージを受信できる電話状態の変更とイベントのセットを指定します。 監視は個別に有効または無効にすることができます。
lpdwButtonModes
アプリケーションが通知メッセージを受信できる電話ボタン モードのセットを指定するフラグを含む DWORD へのポインター。 このパラメーターでは、0 個の 1 つ以上の PHONEBUTTONMODE_定数を使用します。
lpdwButtonStates
アプリケーションが通知メッセージを受信できる電話ボタンの状態変更のセットを指定するフラグを含む DWORD へのポインター。 このパラメーターでは、0 個の 1 つ以上の PHONEBUTTONSTATE_定数を使用します。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_OPERATIONFAILED、PHONEERR_UNINITIALIZED。
注釈
アプリケーションでは 、phoneGetStatusMessages を使用して、対応するメッセージの生成を照会できます。 メッセージの生成は 、phoneGetStatusMessages によって制御できます。 既定では、すべての電話ステータス メッセージが無効になっています。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | tapi.h |
Library | Tapi32.lib |
[DLL] | Tapi32.dll |