TSPI_lineAnswer関数 (tspi.h)

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

TSPI_lineAnswer関数は、指定したオファリング呼び出しに応答します。

構文

LONG TSPIAPI TSPI_lineAnswer(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

パラメーター

dwRequestID

非同期要求の識別子。

hdCall

応答する呼び出しに対するサービスプロバイダーのハンドル。 hdCall の呼び出し状態は、オファリングまたは受け入れ可能です。

lpsUserUserInfo

呼び出しに応答する際にリモートパーティに送信されるユーザーユーザー情報を含む null で終わる文字列へのポインター。このポインターが NULL の場合は、ユーザーとユーザーの情報が送信されていないことを示します。ユーザーユーザー情報は、基になるネットワークでサポートされている場合にのみ送信されます ( LINEDEVCAPS で示されています)。

dwSize

lpsUserUserInfo のユーザーユーザー情報のサイズ (バイト単位)。 lpsUserUserInfo が NULL の場合、dwSize は無視されます。

戻り値

エラーが発生した場合は 、dwRequestID またはエラー番号を返します。関数が成功した場合は対応するASYNC_COMPLETIONの lResult 実際のパラメーターは 0、エラーが発生した場合はエラー番号です。可能な戻り値は次のとおりです。

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INUSE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_USERUSERINFOTOOBIG。

注釈

新しい呼び出しが到着すると、サービスプロバイダーは TAPI にLINE_NEWCALL メッセージを送信して、呼び出しのハンドルを交換します。サービスプロバイダーは、TAPI とそのクライアントアプリケーションに呼び出しの状態を通知する LINE_CALLSTATE メッセージでこれに従います。クライアントアプリケーションは通常、 TSPI_lineAnswerを使用して呼び出しに応答します。通常、呼び出しに正常に応答すると、呼び出しは接続状態に遷移します。

一部のテレフォニー環境 (ISDN など) では、ユーザーアラートが通話サービスから分離されている場合、TAPI とそのクライアントアプリケーションには、応答する前に最初に通話を受け入れるか、代わりに オファリング 呼び出しを拒否またはリダイレクトするオプションがあります。

別の呼び出しが既にアクティブになっているときに呼び出しが提供されている場合は、 TSPI_lineAnswerを呼び出すことによって、新しい呼び出しがに接続されます。これが既存のアクティブな呼び出しに与える影響は、回線のデバイス機能によって異なります。最初の呼び出しは影響を受けないか、自動的に削除されるか、自動的に保留にされる可能性があります。適切なLINE_CALLSTATE メッセージは、両方の呼び出しについて TAPI への状態遷移を報告するために使用されます。