TSPI_lineSendUserUserInfo関数 (tspi.h)
TSPI_lineSendUserUserInfo関数は、指定した呼び出しでリモート パーティにユーザーユーザー情報を送信します。
構文
LONG TSPIAPI TSPI_lineSendUserUserInfo(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
パラメーター
dwRequestID
非同期要求の識別子。
hdCall
ユーザーとユーザーの情報を送信する呼び出しのハンドル。 hdCall の呼び出し状態は、接続、オファリング、受け入れ、またはリングバックできます。
lpsUserUserInfo
リモート パーティに送信されるユーザーとユーザーの情報を含む null で終わる Unicode 文字列へのポインター。 ユーザーとユーザーの情報は、基になるネットワークでサポートされている場合にのみ送信されます ( LINEDEVCAPS を参照してください)。
dwSize
lpsUserUserInfo のユーザーユーザー情報のサイズ (null 終端記号を含むバイト単位)。
戻り値
dwRequestID を返します。エラーが発生した場合はエラー番号を返します。 関数が成功した場合は対応するASYNC_COMPLETIONの実際のパラメーター lResult は 0、エラーが発生した場合はエラー番号です。 可能な戻り値は次のとおりです。
LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSTATE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_USERUSERINFOTOOBIG、LINEERR_OPERATIONUNAVAIL。
解説
この関数を使用すると、接続された呼び出し中にいつでもユーザーとユーザーの情報を送信できます。 送信する指定された情報のサイズが 1 つのネットワーク メッセージに収まるサイズよりも大きい場合 (ISDN のように)、サービス プロバイダーは、情報をチェーンされたネットワーク メッセージのシーケンスに分割する ("より多くのデータ" を使用) 責任を負います。
ユーザーとユーザーの情報は、通話の受け入れ、呼び出し拒否、呼び出しのリダイレクトの一部として、呼び出しを行うときにも送信できます。 ユーザーとユーザーの情報を受信することもできます。 受信した情報は、呼び出しの LINECALLINFO 構造体で報告されます。 呼び出しオファリングの後、または通話切断の前にユーザーとユーザーの情報が到着するたびに、UserUserInfo パラメーターを持つLINE_CALLINFO メッセージは、呼び出し情報レコード内のユーザーユーザー情報が変更されたことを TAPI に通知します。 複数のネットワーク メッセージがチェーンされている場合、情報はサービス プロバイダーによってアセンブルされ、1 つのメッセージが TAPI に送信されます。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |