lineGetStatusMessages 関数 (tapi.h)

[アーティクル]
08/26/2023

lineGetStatusMessages 関数を使用すると、アプリケーションは、指定された行またはそのアドレスの状態の変更に関連するイベントを受信するようにアプリケーションが設定した通知メッセージに対してクエリを実行できます。

構文

LONG lineGetStatusMessages(
  HLINE   hLine,
  LPDWORD lpdwLineStates,
  LPDWORD lpdwAddressStates
);

パラメーター

hLine

ラインデバイスへのハンドル。

lpdwLineStates

メッセージをアプリケーションに送信する行デバイスの状態が変更される対象を識別するビット配列。フラグが TRUE の場合、そのメッセージは有効になります。 FALSE の場合は無効になります。このパラメーターでは、1 つ以上の LINEDEVSTATE_定数を使用します。

lpdwAddressStates

メッセージが変更されるアドレスの状態を識別するビット配列をアプリケーションに送信します。フラグが TRUE の場合、そのメッセージは有効になります。 FALSE の場合は無効です。このパラメーターでは、1 つ以上の LINEADDRESSSTATE_定数を使用します。

戻り値

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

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

注釈

TAPI は、行とアドレスで発生するイベントについてアプリケーションに通知するメッセージの数を定義します。アプリケーションは、すべてのアドレスと行の状態変更メッセージを受信することに関心がない場合があります。 lineSetStatusMessages 関数を使用して、アプリケーションが受信するメッセージを選択できます。既定では、住所の状態と行の状態のレポートは無効になっています。