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 によって制御できます。既定では、すべての電話ステータスメッセージが無効になっています。