lineSetStatusMessages 関数 (tapi.h)

[アーティクル]
03/02/2024

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

構文

LONG lineSetStatusMessages(
  HLINE hLine,
  DWORD dwLineStates,
  DWORD dwAddressStates
);

パラメーター

hLine

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

dwLineStates

メッセージが変更される回線デバイスの状態を識別するビット配列をアプリケーションに送信します。このパラメーターは、1 つ以上の LINEDEVSTATE_定数を使用します。

dwAddressStates

メッセージが変更されたアドレスの状態を識別するビット配列をアプリケーションに送信します。このパラメーターは、1 つ以上の LINEADDRESSSTATE_定数を使用します。

戻り値

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

LINEERR_INVALADDRESSSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINESTATE、LINEERR_UNINITIALIZED、LINEERR_NOMEM、LINEERR_OPERATIONUNAVAIL。

注釈

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