lineGetCallInfo 関数 (tapi.h)

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

lineGetCallInfo 関数を使用すると、アプリケーションは指定した呼び出しに関する固定情報を取得できます。

構文

LONG lineGetCallInfo(
  HCALL          hCall,
  LPLINECALLINFO lpCallInfo
);

パラメーター

hCall

クエリを実行する呼び出しを処理します。 hCall の呼び出し状態には、任意の状態を指定できます。

lpCallInfo

LINECALLINFO 型の可変サイズのデータ構造へのポインター。要求が正常に完了すると、この構造体には呼び出し関連の情報が入力されます。 lineGetCallInfo を呼び出す前に、アプリケーションは、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示す必要があります。

戻り値

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

LINEERR_INVALCALLHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL。

注釈

着信または発信呼び出しごとに、個別の LINECALLINFO 構造体が存在します。構造体には、主に呼び出しに関する固定情報が含まれています。通常、アプリケーションは、 LINE_CALLSTATE メッセージによって呼び出しのハンドルを受け取るとき、または呼び出し情報構造の一部が変更されたことを LINE_CALLINFO メッセージによって通知を受信するたびに、この情報を確認することに関心があります。これらのメッセージは、呼び出しのハンドルをパラメーターとして提供します。