lineGetNewCalls 関数 (tapi.h)

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

lineGetNewCalls 関数は、アプリケーションが現在ハンドルを持っていない指定された行またはアドレスでの呼び出しに対して呼び出しハンドルを返します。アプリケーションには、これらの呼び出しに対するモニター特権が付与されます。

構文

LONG lineGetNewCalls(
  HLINE          hLine,
  DWORD          dwAddressID,
  DWORD          dwSelect,
  LPLINECALLLIST lpCallList
);

パラメーター

hLine

開いている回線デバイスへのハンドル。

dwAddressID

指定されたオープンラインデバイスのアドレス。アドレス識別子は、アドレスに完全に関連付けられます。識別子は、オペレーティングシステムのアップグレード間で一定のままです。

dwSelect

要求される呼び出しの選択。このパラメーターは、 LINECALLSELECT_定数の 1 つだけを使用します。

lpCallList

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

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

戻り値

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

LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSELECT、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM。

注釈

アプリケーションでは 、lineGetNewCalls を使用して、現在ハンドルがない呼び出しのハンドルを取得できます。アプリケーションは、スコープ (指定した行での呼び出し、または指定したアドレスでの呼び出し) に基づいて、ハンドルを返す呼び出しを選択できます。たとえば、アプリケーションは、現在ハンドルがない特定のアドレスのすべての呼び出しに対して呼び出しハンドルを要求できます。アプリケーションには常に、新しい呼び出しハンドルに対するモニター特権が付与されます。また、行を開くときに、アプリケーションはこの関数を使用して既存の呼び出しを認識します。

アプリケーションは、リスト内の各呼び出しに対して lineGetCallInfo と lineGetCallStatus を呼び出して、呼び出しの情報と状態をそれぞれ決定できます。 lineSetCallPrivilege を使用して、その特権を所有者に変更できます。