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 |