セッション情報
TAPI アプリケーションが適切に機能するには、さまざまなセッション情報を収集して処理する必要があります。 たとえば、セッションが "オファリング" 状態でない限り、応答操作は失敗します。
TAPI 2.x: アプリケーションは、主に lineGetCallInfo 関数を使用してセッション情報にアクセスします。 セッション情報を操作する追加の関数は、lineGetCallStatus、lineSetCallParams、lineSetCallData、lineSetCallTreatment、lineSetCallPrivilege、lineGetCallStatus、lineSendUserUserInfo です。
TAPI 3.x: アプリケーションは、主に ITCallInfo インターフェイスを使用してセッション情報にアクセスします。
| 情報 | TAPI 2.x | TAPI 3.x |
|---|---|---|
| セッションのアドレスの種類 | lineGetCallInfo、LINECALLINFO のメンバー dwAddressType | ITCallInfo::get_CallInfoLong は、CALLINFO_LONG の CIL_CALLERIDADDRESSTYPE、CIL_CALLEDIDADDRESSTYPE、CIL_CONNECTEDIDADDRESSTYPE のいずれかのメンバーと共に呼び出されます。 |
| アプリケーション固有の情報 | lineGetCallInfo、LINECALLINFOlineSetAppSpecific のメンバー dwAppSpecific |
ITCallInfo::get_CallInfoLong または ITCallInfo::put_CallInfoLong は、CALLINFO_LONG のメンバー CIL_APPSPECIFIC と共に呼び出されます。 |
| ベアラー モード | lineGetCallInfo、LINECALLINFOlineSetCallParams のメンバー dwBearerMode |
ITCallInfo::get_CallInfoLong または ITCallInfo::put_CallInfoLong は、CALLINFO_LONG のメンバー CIL_BEARERMODE と共に呼び出されます。 |
| 通話データ バッファー | lineGetCallInfo、LINECALLINFOlineSetCallData のメンバー dwCallDataSize および dwCallDataOffset |
ITCallInfo::GetCallInfoBuffer は、CALLINFO_BUFFER のメンバー CIB_CALLDATABUFFER と共に呼び出されます |
| 通話 ID | lineGetCallInfo、LINECALLINFO のメンバー dwCallID | ITCallInfo::get_CallInfoLongは、CALLINFO_LONG のメンバー CIL_CALLID と共に呼び出されます。 |
| 着信識別 | lineGetCallInfo と LINECALLINFO のメンバー dwCalledIDSize、dwCalledIDOffset、dwCalledIDNameSize、dwCalledIDNameOffset、dwCallDataOffset | ITCallInfo::get_CallInfoString または ITCallInfo::p ut_CallInfoString は、CALLINFO_STRING のメンバー CIS_CALLINGPARTYID と共に呼び出されます。 |
| 着信側のフレンドリ名 | NA | ITCallInfo::get_CallInfoString または ITCallInfo::p ut_CallInfoString は、CALLINFO_STRING のメンバー CIS_CALLEDPARTYFRIENDLYNAME と共に呼び出されます。 |
| 発信者 ID | lineGetCallInfo と LINECALLINFO のメンバー dwCallerIDSize、dwCallerIDOffset、dwCallerIDNameSize、dwCallerIDNameOffset | ITCallInfo::get_CallInfoString は、CALLINFO_STRING の CIS_CALLERIDNAME、CIS_CALLERIDNUMBER、CIS_CALLEDIDNAME、CIS_CALLEDIDNUMBER のいずれかのメンバーと共に呼び出されます。 |
| CallHub インターフェイス ポインター | NA | ITCallInfo::get_CallHubITTAPI::EnumerateCallHubs |
| 課金情報 | lineGetCallInfo、LINECALLINFO のメンバー dwChargingInfoSize および dwChargingInfoOffset。 | ITCallInfo::GetCallInfoBuffer は、CALLINFO_BUFFER のメンバー CIB_CHARGINGINFOBUFFER と共に呼び出されます |
| コメント | lineGetCallInfo、LINECALLINFO のメンバー dwCommentSize および dwCommentOffset。 | ITCallInfo::get_CallInfoString または ITCallInfo::p ut_CallInfoString は、CALLINFO_STRING のメンバー CIS_COMMENT と共に呼び出されます。 |
| 互換性バッファー | lineGetCallInfo、LINECALLINFO の dwHighLevelCompSize、dwHighLevelCompOffset、dwLowLevelCompSize、dwLowLevelCompOffset のいずれかのメンバー。 | ITCallInfo::GetCallInfoBuffer は、CALLINFO_BUFFER のメンバー CIB_HIGHLEVELCOMPATIBILITYBUFFER または CIB_LOWLEVELCOMPATIBILITYBUFFER と共に呼び出されます |
| 完了 ID | lineGetCallInfo、LINECALLINFO のメンバー dwCompletionID | ITCallInfo::get_CallInfoLong は、CALLINFO_LONG のメンバー CIL_COMPLETIONID と共に呼び出されます。 |
| 接続された ID | lineGetCallInfo、LINECALLINFO の dwConnectedIDSize、dwConnectedIDOffset、dwConnectedIDNameSize、dwConnectedIDNameOffset のいずれかのメンバー | ITCallInfo::get_CallInfoString は、CALLINFO_STRING のメンバー CIS_CONNECTEDIDNAME または CIS_CONNECTEDIDNUMBER と共に呼び出されます。 |
| 国または地域のコード | lineGetCallInfo、LINECALLINFO のメンバー dwCountryCode | ITCallInfo::get_CallInfoLong または ITCallInfo::put_CallInfoLong は、CALLINFO_LONG のメンバー CIL_COUNTRYCODE と共に呼び出されます。 |
| デバイス固有のバッファー | lineGetCallInfo、LINECALLINFO のメンバー dwDevSpecificSize および dwDevSpecificOffset | ITCallInfo::GetCallInfoBuffer は、CALLINFO_BUFFER のメンバー CIB_DEVSPECIFICBUFFER と共に呼び出されます |
| 表示可能なアドレス | lineGetCallInfo、LINECALLINFO のメンバー dwDisplayableAddressSize および dwDisplayableAddressOffset | ITCallInfo::get_CallInfoString または ITCallInfo::p ut_CallInfoString は、CALLINFO_STRING のメンバー CIS_DISPLAYABLEADDRESS と共に呼び出されます。 |
| セッションのメディアの種類 | lineGetCallInfo、LINECALLINFO のメンバー dwMediaMode | ITCallInfo::get_CallInfoLong は、CALLINFO_LONG のメンバー CIL_MEDIATYPESAVAILABLE と共に呼び出されます。 |
| 元のドメイン | lineGetCallInfo、LINECALLINFO のメンバー dwOrigin | ITCallInfo::get_CallInfoLong は、CALLINFO_LONG のメンバー CIL_ORIGIN と共に呼び出されます。 |
| パラメータ フラグ | lineGetCallInfo、LINECALLINFOlineSetCallParams のメンバー dwCallParamFlags |
ITCallInfo::get_CallInfoLong または ITCallInfo::put_CallInfoLong は、CALLINFO_LONG のメンバー CIL_CALLPARAMSFLAGS と共に呼び出されます。 |
| 権限 | lineGetCallStatus、LINECALLSTATUSlineSetCallPrivilege のメンバー dwCallPrivilege |
ITCallInfo::get_Privilege または ITCallInfo::get_CallInfoLong は、CALLINFO_LONG のメンバー CIL_NUMBEROFOWNERS または CIL_NUMBEROFMONITORS と共に呼び出されます。 |
| サービスの品質 | lineSetCallQualityOfService、lineGetCallInfo、LINECALLPARAMS のメンバー dwSendingFlowspecSize、dwSendingFlowspecOffset、dwReceivingFlowspecSize、dwReceivingFlowspecOffset | ITBasicCallControl::SetQOS、ITQOSEvent |
| 率 | lineGetCallInfo、LINECALLINFOlineSetCallParams のメンバー dwRate |
ITCallInfo::get_CallInfoLong または ITCallInfo::put_CallInfoLong は、CALLINFO_LONG の CIL_MAXRATE、CIL_MINRATE、CIL_RATE のいずれかのメンバーと共に呼び出されます。 |
| 理由 | lineGetCallInfo、LINECALLINFO のメンバー dwReason | ITCallInfo::get_CallInfoLong は、CALLINFO_LONG のメンバー CIL_REASON と共に呼び出されます。 |
| リダイレクト識別 | lineGetCallInfo、LINECALLINFO の dwRedirectionIDSize、dwRedirectionIDOffset、dwRedirectionIDNameSize、dwRedirectionIDNameOffset、dwRedirectingIDSize、dwRedirectingIDOffset、dwRedirectingIDNameSize、dwRedirectingIDNameOffset のいずれかのメンバー | ITCallInfo::get_CallInfoString は、CALLINFO_STRING の CIS_REDIRECTIONIDNAME、CIS_REDIRECTIONIDNUMBER、CIS_REDIRECTINGIDNAME、CIS_REDIRECTINGIDNUMBER のいずれかのメンバーと共に呼び出されます。 |
| State | lineGetCallStatus、LINECALLSTATUS のメンバー dwCallState。 | ITCallInfo::get_CallState |
| 処理 | lineGetCallInfo、LINECALLINFOlineSetCallTreatment のメンバー dwCallTreatment |
ITCallInfo::get_CallInfoLong または ITCallInfo::put_CallInfoLong は、CALLINFO_LONG のメンバー CIL_CALLTREATMENT と共に呼び出されます。 |
| トランク | lineGetCallInfo、LINECALLINFO のメンバー dwTrunk | ITCallInfo::get_CallInfoLongは、CALLINFO_LONG のメンバー CIL_TRUNK と共に呼び出されます。 |
| ユーザー/ユーザー情報 | lineGetCallInfo、LINECALLINFOlineSendUserUserInfo のメンバー dwCallDataSize および dwCallDataOffset |
ITCallInfo::GetCallInfoBuffer は、CALLINFO_BUFFER のメンバー CIB_USERUSERINFO と ITCallInfo::ReleaseUserUserInfo と共に呼び出されます。 |