lineAccept 関数 (tapi.h)

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

lineAccept 関数は、指定された呼び出しを受け入れます。必要に応じて、指定されたユーザーとユーザーの情報を呼び出し元に送信できます。

構文

LONG lineAccept(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

パラメーター

hCall

受け入れられる呼び出しを処理します。アプリケーションは、呼び出しの所有者である必要があります。 hCall の呼び出し状態はオファリングである必要があります。

lpsUserUserInfo

呼び出しの一部としてリモートパーティに送信されるユーザーとユーザーの情報を含む null で終わる文字列へのポインターが受け入れられます。ユーザーとユーザーの情報を送信しない場合は、このポインターを NULL のままに することができます。ユーザーとユーザーの情報は、基になるネットワークでサポートされている場合にのみ送信されます ( LINEDEVCAPS を参照してください)。ユーザーユーザー情報のプロトコル判別メンバー (必要な場合) は、 lpsUserUserInfo が指すバッファーの最初のバイトとして表示され、 dwSize ではを考慮する必要があります。

dwSize

lpsUserUserInfo (null ターミネータを含む) 内のユーザーユーザー情報のサイズ (バイト単位)。 lpsUserUserInfo が NULL の場合、ユーザーユーザー情報は呼び出し元に送信されません。dwSize は無視されます。

戻り値

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

LINEERR_INVALCALLHANDLE、LINEERR_INVALCALLSTATE、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_NOTOWNER、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED、LINEERR_USERUSERINFOTOOBIG。

注釈

lineAccept 関数は、Integrated Services Digital Network (ISDN) などのテレフォニー環境で使用されます。これにより、着信呼び出しに関連付けられたアラートを、通話の初期オファリングとは別にすることができます。呼び出しが入ると、最初に提供されます。アプリケーションには、 lineDrop を使用して呼び出しを拒否したり、 lineRedirect を使用して別のステーションに呼び出しをリダイレクトしたり、 lineAnswer を使用して通話に応答したり、 lineAccept を使用して呼び出しを受け入れるオプションがある場合があります。アプリケーションによって呼び出しが正常に受け入れられると、呼び出し元デバイスと呼び出し元デバイスの両方でアラートが開始され、通常、呼び出し状態は 受け入れられる状態に遷移します。

アラートは、LINE_LINEDEVSTATE メッセージと呼び出し表示によってアプリケーションに報告されます。

lineAccept 関数は、ISDN 以外のサービスプロバイダーでもサポートされる場合があります。受け入れられるへの呼び出し状態遷移は、別のアプリケーションが呼び出しの責任を主張し、ユーザーに呼び出しを提示したことを示すために、他のアプリケーションで使用できます。

アプリケーションには、受け入れ時にユーザーとユーザーの情報を送信するオプションがあります。ユーザーとユーザーの情報が送信された場合でも、ネットワークがこの情報を呼び出し元に配信するという保証はありません。アプリケーションは、回線のデバイス機能を調べて、呼び出しの受け入れを使用できるかどうかを判断する必要があります。