Informações de sessão
Os aplicativos TAPI devem reunir e processar uma variedade de informações de sessão para funcionar corretamente. Por exemplo, uma operação de resposta falha, a menos que a sessão esteja no estado de “oferta”.
TAPI 2.x: os aplicativo usam principalmente a função lineGetCallInfo para acessar informações de sessão. Funções adicionais que manipulam informações de sessão são lineGetCallStatus, lineSetCallParams, lineSetCallData, lineSetCallTreatment, lineSetCallPrivilege, lineGetCallStatus e lineSendUserUserInfo.
TAPI 3.x: os aplicativos usam principalmente a interface ITCallInfo para acessar informações de sessão.
| Informações | TAPI 2.x | TAPI 3.x |
|---|---|---|
| Tipo de endereço para uma sessão | lineGetCallInfo, dwAddressType, membro de LINECALLINFO | ITCallInfo::get_CallInfoLong, chamado com o membro CIL_CALLERIDADDRESSTYPE, CIL_CALLEDIDADDRESSTYPE ou CIL_CONNECTEDIDADDRESSTYPE de CALLINFO_LONG. |
| Informações específicas do aplicativo | lineGetCallInfo, dwAppSpecific, membro de LINECALLINFOlineSetAppSpecific |
ITCallInfo::get_CallInfoLong ou ITCallInfo::put_CallInfoLong, chamado com o membro CIL_APPSPECIFIC de CALLINFO_LONG. |
| Modo portador | lineGetCallInfo, dwBearerMode, membro de LINECALLINFOlineSetCallParams |
ITCallInfo::get_CallInfoLong ou ITCallInfo::put_CallInfoLong, chamado com o membro CIL_BEARERMODE de CALLINFO_LONG. |
| Buffer de dados de chamada | lineGetCallInfo, dwCallDataSize e dwCallDataOffset, membros de LINECALLINFOlineSetCallData |
ITCallInfo::GetCallInfoBuffer, chamado com o membro CIB_CALLDATABUFFER de CALLINFO_BUFFER |
| ID de chamada | lineGetCallInfo, dwCallID, membro de LINECALLINFO | ITCallInfo::get_CallInfoLong, chamado com o membro CIL_CALLID de CALLINFO_LONG. |
| Identificação da parte chamada | lineGetCallInfo com dwCalledIDSize, dwCalledIDOffset, dwCalledIDNameSize, dwCalledIDNameOffset e dwCallDataOffset, membros de LINECALLINFO | ITCallInfo::get_CallInfoString ou ITCallInfo::put_CallInfoString, chamado com o membro CIS_CALLINGPARTYID de CALLINFO_STRING. |
| Nome amigável da parte chamada | NA | ITCallInfo::get_CallInfoString ou ITCallInfo::put_CallInfoString, chamado com o membro CIS_CALLEDPARTYFRIENDLYNAME de CALLINFO_STRING. |
| Identificação do chamador | lineGetCallInfo com dwCallerIDSize, dwCallerIDOffset, dwCallerIDNameSize e dwCallerIDNameOffset, membros de LINECALLINFO | ITCallInfo::get_CallInfoString, chamado com o membro CIS_CALLERIDNAME, CIS_CALLERIDNUMBER, CIS_CALLEDIDNAME ou CIS_CALLEDIDNUMBER de CALLINFO_STRING. |
| Ponteiro de interface do CallHub | NA | ITCallInfo::get_CallHubITTAPI::EnumerateCallHubs |
| Informações de carregamento | lineGetCallInfo, dwChargingInfoSize e dwChargingInfoOffset, membros de LINECALLINFO. | ITCallInfo::GetCallInfoBuffer, chamado com o membro CIB_CHARGINGINFOBUFFER de CALLINFO_BUFFER |
| Comentário | lineGetCallInfo, dwCommentSize e dwCommentOffset, membros de LINECALLINFO. | ITCallInfo::get_CallInfoString ou ITCallInfo::put_CallInfoString, chamado com o membro CIS_COMMENT de CALLINFO_STRING. |
| Buffer de compatibilidade | lineGetCallInfo, dwHighLevelCompSize, dwHighLevelCompOffset, dwLowLevelCompSize ou dwLowLevelCompOffset, membros de LINECALLINFO. | ITCallInfo::GetCallInfoBuffer, chamado com o membro CIB_HIGHLEVELCOMPATIBILITYBUFFER ou CIB_LOWLEVELCOMPATIBILITYBUFFER de CALLINFO_BUFFER |
| ID de conclusão | lineGetCallInfo, dwCompletionID, membro de LINECALLINFO | ITCallInfo::get_CallInfoLong, chamado com o membro CIL_COMPLETIONID de CALLINFO_LONG. |
| Identificação conectada | lineGetCallInfo, dwConnectedIDSize, dwConnectedIDOffset, dwConnectedIDNameSize ou dwConnectedIDNameOffset, membro de LINECALLINFO | ITCallInfo::get_CallInfoString, chamado com o membro CIS_CONNECTEDIDNAME ou CIS_CONNECTEDIDNUMBER de CALLINFO_STRING. |
| Código de país ou região | lineGetCallInfo, dwCountryCode, membro de LINECALLINFO | ITCallInfo::get_CallInfoLong ou ITCallInfo::put_CallInfoLong, chamado com o membro CIL_COUNTRYCODE de CALLINFO_LONG. |
| Buffer específico do dispositivo | lineGetCallInfo, dwDevSpecificSize e dwDevSpecificOffset, membros de LINECALLINFO | ITCallInfo::GetCallInfoBuffer, chamado com o membro CIB_DEVSPECIFICBUFFER de CALLINFO_BUFFER |
| Endereço para exibição | lineGetCallInfo, dwDisplayableAddressSize e dwDisplayableAddressOffset, membros de LINECALLINFO | ITCallInfo::get_CallInfoString ou ITCallInfo::put_CallInfoString, chamado com o membro CIS_DISPLAYABLEADDRESS de CALLINFO_STRING. |
| Tipo de mídia para uma sessão | lineGetCallInfo, dwMediaMode, membro de LINECALLINFO | ITCallInfo::get_CallInfoLong, chamado com o membro CIL_MEDIATYPESAVAILABLE de CALLINFO_LONG. |
| Origem | lineGetCallInfo, dwOrigin, membro de LINECALLINFO | ITCallInfo::get_CallInfoLong, chamado com o membro CIL_ORIGIN de CALLINFO_LONG. |
| Sinalizadores de parâmetro | lineGetCallInfo, dwCallParamFlags, membro de LINECALLINFOlineSetCallParams |
ITCallInfo::get_CallInfoLong ou ITCallInfo::put_CallInfoLong, chamado com o membro CIL_CALLPARAMSFLAGS de CALLINFO_LONG. |
| Privilégio | lineGetCallStatus, dwCallPrivilege, membro de LINECALLSTATUSlineSetCallPrivilege |
ITCallInfo::get_Privilege ou ITCallInfo::get_CallInfoLong, chamado com o membro CIL_NUMBEROFOWNERS ou CIL_NUMBEROFMONITORS de CALLINFO_LONG. |
| Qualidade de Serviço | lineSetCallQualityOfService, lineGetCallInfo, dwSendingFlowspecSize, dwSendingFlowspecOffset, dwReceivingFlowspecSize e dwReceivingFlowspecOffset, membros de LINECALLPARAMS | ITBasicCallControl::SetQOS, ITQOSEvent |
| Taxa | lineGetCallInfo, dwRate, membro de LINECALLINFOlineSetCallParams |
ITCallInfo::get_CallInfoLong ou ITCallInfo::put_CallInfoLong, chamado com o membro CIL_MAXRATE, CIL_MINRATE ou CIL_RATE de CALLINFO_LONG. |
| Motivo | lineGetCallInfo, dwReason, membro de LINECALLINFO | ITCallInfo::get_CallInfoLong, chamado com o membro CIL_REASON de CALLINFO_LONG. |
| Identificação de redirecionamento | lineGetCallInfo, dwRedirectionIDSize, dwRedirectionIDOffset, dwRedirectionIDNameSize, dwRedirectionIDNameOffset, dwRedirectingIDSize, dwRedirectingIDOffset, dwRedirectingIDNameSize ou dwRedirectingIDNameOffset, membro de LINECALLINFO | ITCallInfo::get_CallInfoString chamado com o membro CIS_REDIRECTIONIDNAME, CIS_REDIRECTIONIDNUMBER, CIS_REDIRECTINGIDNAME ou CIS_REDIRECTINGIDNUMBER de CALLINFO_STRING. |
| State | lineGetCallStatus, dwCallState, membro de LINECALLSTATUS. | ITCallInfo::get_CallState |
| Tratamento | lineGetCallInfo, dwCallTreatment, membro de LINECALLINFOlineSetCallTreatment |
ITCallInfo::get_CallInfoLong ou ITCallInfo::put_CallInfoLong, chamado com o membro CIL_CALLTREATMENT de CALLINFO_LONG. |
| Tronco | lineGetCallInfo, dwTrunk, membro de LINECALLINFO | ITCallInfo::get_CallInfoLong, chamado com o membro CIL_TRUNK de CALLINFO_LONG. |
| Usuário/informações do usuário | lineGetCallInfo, dwCallDataSize e dwCallDataOffset, membros de LINECALLINFOlineSendUserUserInfo |
ITCallInfo::GetCallInfoBuffer, chamado com o membro CIB_USERUSERINFO de CALLINFO_BUFFER e ITCallInfo::ReleaseUserUserInfo. |