lineReleaseUserUserInfo 関数 (tapi.h)

lineReleaseUserUserInfo 関数は、アプリケーションが LINECALLINFO 構造体に含まれるユーザーユーザー情報を処理し、その後受信したユーザー/ユーザー情報をその構造体に書き込むことができることをサービス プロバイダーに通知します。 サービス プロバイダーは、新しい情報 が 利用可能になったときにLINECALLINFOSTATE_USERUSERINFOを示すLINE_CALLINFO メッセージを送信します。

構文

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

パラメーター

hCall

呼び出しを処理します。 アプリケーションは、呼び出しの所有者である必要があります。 hCall の呼び出し状態には、任意の状態を指定できます。

戻り値

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_NOTOWNER、LINEERR_UNINITIALIZED、LINEERR_OPERATIONUNAVAIL。

解説

lineReleaseUserUserInfo 関数を使用すると、アプリケーションは ISDN 接続に対する受信ユーザーユーザー情報のフローを制御できます。 新しい完全なユーザーユーザー情報メッセージを受信すると、サービス プロバイダーはLINE_CALLINFO メッセージ ( LINECALLINFOSTATE_USERUSERINFO を指定) を使用してアプリケーションに通知します。 任意の数のアプリケーションで ( lineGetCallInfo を使用して) 情報を調べることができますが、呼び出しを所有するアプリケーションは、後続の情報を報告できるように、情報が解放されたときに制御します。 lineReleaseUserUserInfo が呼び出されるまで、サービス プロバイダーは LINECALLINFO の以前のユーザーユーザー情報を新しい情報で上書きしません。 サービス プロバイダーは、呼び出しを所有するアプリケーションによって前の情報が解放されるまで、後で受信したユーザーユーザー情報をバッファーに格納する必要があります。

要件

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

関連項目

LINECALLINFO

LINE_CALLINFO

LINE_REPLY

補助回線サービス関数

TAPI 2.2 リファレンスの概要

lineGetCallInfo