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

関連項目

LINECALLINFO

LINE_CALLINFO

TSPI_lineAccept

TSPI_lineDrop

TSPI_lineGetCallInfo

TSPI_lineMakeCall

TSPI_lineRedirect