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 |