lineGetCallStatus 関数 (tapi.h)

  • [アーティクル]

lineGetCallStatus 関数は、指定された呼び出しの現在の状態を返します。

構文

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

パラメーター

hCall

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

lpCallStatus

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

メモ 構造体のサイズ パラメーターが正しくない場合は、データが上書きされる可能性があります。 構造体サイズの設定の詳細については、 メモリ割り当て に関するトピックを参照してください。
 

戻り値

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

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

解説

lineGetCallStatus 関数は呼び出しの動的状態を返しますが、lineGetCallInfo は主に呼び出しに関する静的な情報を返します。 呼び出し状態情報には、現在の呼び出し状態、この状態の間の呼び出しに関連する詳細なモード情報 (存在する場合) のほか、呼び出しがこの状態の間にアプリケーションが呼び出しで呼び出すことができる API 関数の一覧が含まれます。 通常、アプリケーションは、LINE_CALLSTATE メッセージによる呼び出し状態の変更に関する通知を受け取ったときに、この情報を要求することに関心があります。

要件

   
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

関連項目

基本的なテレフォニー サービス リファレンス

LINECALLSTATUS

LINE_CALLSTATE

TAPI 2.2 リファレンスの概要

lineGetCallInfo