Share via

lineSendUserUserInfo 関数 (tapi.h)

  • [アーティクル]

lineSendUserUserInfo 関数は、指定された呼び出しでユーザーとユーザーの情報をリモート パーティに送信します。

構文

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

パラメーター

hCall

ユーザーとユーザーの情報を送信する呼び出しを処理します。 アプリケーションは、呼び出しの所有者である必要があります。 hCall の呼び出し状態は、接続、オファリング、受け入れ、またはリングバックである必要があります。

lpsUserUserInfo

リモート パーティに送信されるユーザーとユーザーの情報を含む文字列へのポインター。 ユーザーユーザー情報は、基になるネットワークでサポートされている場合にのみ送信されます ( LINEDEVCAPS を参照)。 必要に応じて、ユーザーユーザー情報のプロトコル識別子フィールドは lpsUserUserInfo によって指されるバッファーの最初のバイトとして表示され、 dwSize では を考慮する必要があります。

dwSize

lpsUserUserInfo 内のユーザーユーザー情報のサイズ (バイト単位)。

戻り値

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

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

解説

この関数を使用すると、接続された呼び出し中にユーザーとユーザーの情報をいつでも送信できます。 送信する指定された情報のサイズが、(ISDN のように) 1 つのネットワーク メッセージに収まるサイズよりも大きい場合、サービス プロバイダーは、情報をチェーンされたネットワーク メッセージのシーケンスに分割する必要があります ("より多くのデータ" を使用)。

ユーザーとユーザーの情報は、通話の受け入れ、通話拒否、および呼び出しのリダイレクトの一部として、および呼び出しを行うときに送信することもできます。 ユーザーとユーザーの情報を受信することもできます。 受信した情報は、呼び出しの通話情報レコードを通じて使用できます。 呼び出しのオファリング後、または呼び出しの切断前にユーザーとユーザーの情報が到着するたびに、UserUserInfo パラメーターを持つLINE_CALLINFO メッセージによって、呼び出し情報レコード内のユーザーユーザー情報が変更されたことがアプリケーションに通知されます。 複数のネットワーク メッセージがチェーンされている場合、情報はサービス プロバイダーによってアセンブルされ、1 つのメッセージがアプリケーションに送信されます。

この関数は、暗号化されていない形式でネットワーク経由でデータを送信する場合があります。そのため、ネットワーク上で傍受しているユーザーがデータを読み取ることができる可能性があります。 この方法を使用する前に、クリア テキストでデータを送信するセキュリティ リスクを考慮する必要があります。

要件

   
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

関連項目

LINEDEVCAPS

LINE_CALLINFO

LINE_REPLY

補助回線サービス関数

TAPI 2.2 リファレンスの概要