TSPI_lineAccept関数 (tspi.h)
TSPI_lineAccept関数は、指定された提供された呼び出しを受け入れます。 必要に応じて、指定したユーザーとユーザーの情報を呼び出し元に送信できます。
構文
LONG TSPIAPI TSPI_lineAccept(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
パラメーター
dwRequestID
非同期要求の識別子。
hdCall
受け入れられる呼び出しへのハンドル。 hdCall の呼び出し状態は、オファリングにすることができます。
lpsUserUserInfo
呼び出しの受け入れの一部としてリモート パーティに送信されるユーザーユーザー情報を含む null で終わる Unicode 文字列へのポインター。 ユーザーとユーザーの情報を送信しない場合、このポインターは NULL です。 ユーザーユーザー情報は、基になるネットワークでサポートされている場合にのみ送信されます ( LINEDEVCAPS を参照)。
dwSize
lpsUserUserInfo のユーザーユーザー情報のサイズ (バイト単位)。 lpsUserUserInfo が NULL の場合、dwSize は無視されます。
戻り値
関数が非同期的に完了した場合は dwRequestID を返し、エラーが発生した場合はエラー番号を返します。 対応するASYNC_COMPLETIONの lResult パラメーターは、関数が成功した場合は 0、エラーが発生した場合はエラー番号です。 可能な戻り値は次のとおりです。
LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSTATE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_USERUSERINFOTOOBIG、LINEERR_OPERATIONUNAVAIL。
解説
TSPI_lineAccept関数は、着信呼び出しに関連付けられたアラートを呼び出しの初期オファリングとは別にできるようにするテレフォニー環境 (ISDN など) で使用されます。 通話が着信すると、最初に呼び出しが提供されます。 しばらくの間、クライアント アプリケーションでは、TSPI_lineDropを使用して呼び出しを拒否したり、TSPI_lineRedirectを使用して別のステーションに呼び出しをリダイレクトしたり、TSPI_lineAnswerを使用して通話に応答したり、TSPI_lineAcceptを使用して呼び出しを受け入れたりすることができます。 呼び出しが正常に受け入れられた後、呼び出し元と呼び出し元の両方のデバイスでアラートが開始され、通常は呼び出し状態 が受け入れられた 状態に遷移します。 アプリケーションが警告を開始するためにTSPI_lineAcceptを呼び出す必要がある場合、サービス プロバイダーは LINEADDRESSCAPS データ構造の dwAddrCapFlags メンバーにフラグ LINEADDRCAPFLAGS_ACCEPTTOALERTを設定する必要があります。
TAPI では、LINE_LINEDEVSTATE メッセージと呼び出し表示を使用してアラートが報告されます。
TSPI_lineAccept は、ISDN 以外のサービス プロバイダーでもサポートされる場合があります。 受け入れられた状態への呼び出し状態遷移は、一部のアプリケーションが呼び出しの責任を主張し、ユーザーに呼び出しを提示したことを示すために、他の TAPI クライアントで使用できます。
クライアント アプリケーションには、受け入れ時にユーザーとユーザーの情報を送信するオプションがあります。 ユーザーとユーザーの情報を送信できる場合でも、多くの場合、ネットワークがこの情報を呼び出し元に配信することは保証されません。 クライアント アプリケーションは、回線のデバイス機能を調べて、呼び出しの受け入れ可能かどうかを判断できます。
必要条件
対象プラットフォーム | Windows |
ヘッダー | tspi.h |