lineCompleteCall 関数 (tapi.h)

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

lineCompleteCall 関数は、通常接続できなかった呼び出しを代わりに完了する方法を指定します。ネットワークリソースがビジー状態であるか、リモートステーションがビジー状態であるか応答しないため、ネットワークまたはスイッチが通話を完了できない場合があります。アプリケーションは、いくつかの方法のいずれかで呼び出しを完了することを要求できます。

構文

LONG lineCompleteCall(
  HCALL   hCall,
  LPDWORD lpdwCompletionID,
  DWORD   dwCompletionMode,
  DWORD   dwMessageID
);

パラメーター

hCall

完了が要求された呼び出しを処理します。アプリケーションは、呼び出しの所有者である必要があります。 hCall の呼び出し状態は、ビジーまたはリングバックである必要があります。

lpdwCompletionID

DWORD サイズのメモリ位置へのポインター。完了識別子は、進行中の個々の完了要求を識別するために使用されます。完了識別子が無効になり、要求が完了した後、または未処理の要求が取り消された後に再利用できます。

dwCompletionMode

呼び出しを完了する方法。このパラメーターは、 LINECALLCOMPLMODE_定数の 1 つだけを使用します。

dwMessageID

LINECALLCOMPLMODE_MESSAGEを使用して呼び出しを完了するときに送信されるメッセージ。この識別子は、少数の定義済みメッセージからメッセージを選択します。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。対応するLINE_REPLY メッセージの dwParam2 パラメーターは、関数が成功した場合は 0、エラーが発生した場合は負のエラー番号です。可能な戻り値は次のとおりです。

LINEERR_COMPLETIONOVERRUN、LINEERR_NOMEM、LINEERR_INVALCALLCOMPLMODE、LINEERR_NOTOWNER、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALMESSAGEID、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED。

注釈

この関数は、要求がネットワークまたはスイッチによって受け入れられた場合に完了したと見なされます。要求が指定された方法で完全に完了した場合は、ではありません。この関数が完了すると、呼び出しは通常 アイドル状態に遷移します。呼び出されたステーションまたはネットワークが、要求に応じて呼び出しを完了できる状態になると、呼び出し状態がオファリングと等しいLINE_CALLSTATE メッセージによってアプリケーションに通知されます。呼び出しの LINECALLINFO レコードは、呼び出しの理由を CALLCOMPLETION として一覧表示し、完了識別子も提供します。複数の未処理の呼び出し完了要求を持つことができます。最大数はデバイスによって異なります。完了識別子は個々の要求を参照するためにも使用されるため、 lineUncompleteCall を呼び出して要求を取り消すことができます。