TSPI_lineReleaseUserUserInfo関数 (tspi.h)

[アーティクル]
03/13/2024

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

構文

LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

パラメーター

dwRequestID

非同期要求の識別子。

hdCall

ユーザーとユーザーの情報を解放する呼び出しに対するサービスプロバイダーのハンドル。 hdCall の呼び出し状態は任意です。

戻り値

dwRequestID を返します。エラーが発生した場合はエラー番号を返します。関数が成功した場合は対応するASYNC_COMPLETIONの実際のパラメーター lResult は 0、エラーが発生した場合はエラー番号です。可能な戻り値は次のとおりです。

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。

注釈

TSPI_lineReleaseUserUserInfo関数を使用すると、ISDN 接続に対する受信ユーザーとユーザー情報のフローを制御できます。新しい完全なユーザーユーザー情報メッセージを受信すると、サービスプロバイダーはLINE_CALLINFO メッセージ ( LINECALLINFOSTATE_USERUSERINFO を指定) を使用して TAPI に通知します。 LINECALLINFO のユーザーとユーザーの情報およびその他のフィールドは、TSPI_lineGetCallInfoへの複数の呼び出しによって調べることができます。サービスプロバイダーは、TSPI_lineReleaseUserUserInfoが呼び出されるまで、LINECALLINFO の以前のユーザーユーザー情報を新しい情報で上書きすることはできません。サービスプロバイダーは、前の情報が解放されるまで、後で受信したユーザーユーザー情報をバッファーに格納する必要があります。バッファー内の残りの情報は、 TSPI_lineCloseCall が呼び出されたときに破棄できます。

LINECALLINFO にユーザーユーザー情報がないときにこの関数が呼び出された場合、サービスプロバイダーは成功の兆候を返す必要があります。

下位互換性のために、TAPI は、関数をエクスポートしないサービスプロバイダーの制御下にある行の呼び出しに対してこの関数が呼び出された場合、LINEERR_OPERATIONUNAVAILを自動的に返します。