Staat

Sessie- of oproepstatus geeft de huidige status van een sessie aan, zoals 'aanbieding' of 'verbonden'. De juiste verwerking van statusinformatie is essentieel voor de goede werking van de meeste TAPI-toepassingen. De antwoordbewerking kan bijvoorbeeld alleen worden uitgevoerd op een aangeboden sessie, maar een overdracht mislukt als de sessie zich in die status bevindt.

De status van een sessie verandert als gevolg van gebeurtenissen. Gebeurtenissen kunnen worden gevraagd of ongevraagd. aangevraagde gebeurtenissen worden veroorzaakt door de toepassing die de sessie beheert, bijvoorbeeld wanneer er een TAPI-sessiebewerking wordt aangeroepen. Ongevraagde gebeurtenissen worden veroorzaakt door de switch, het telefoonnetwerk, de gebruiker die op de lokale telefoon drukt of de acties van de externe partij.

Wanneer een serviceprovider een wijziging van de sessiestatus detecteert, rapporteert deze de wijziging aan TAPI en TAPI geeft een gebeurtenismelding uit aan alle eigenaar en bewaakt deze toepassingen. De toepassing moet op deze meldingen reageren. Zie gebeurtenismelding onder TAPI-initialisatie voor informatie over het beheren van welke gebeurtenissen aan een toepassing worden gerapporteerd.

Een toepassing moet altijd status gebeurtenismeldingen verwerken. Statusovergangen die geldig zijn voor een fysieke configuratie, zijn mogelijk ongeldig voor een andere. Denk bijvoorbeeld aan een lijn die zowel op de computer als bij een afzonderlijke telefoonset fysiek wordt beëindigd, waardoor er een configuratie van een partijlijn tussen de computer en de telefoonset wordt gemaakt. Een toepassing die op de computer wordt uitgevoerd, weet mogelijk niet over activiteiten van telefoonsets. Dat wil gezegd, de lijn kan in gebruik zijn zonder dat de serviceprovider hiervan op de hoogte is. Een toepassing die probeert een uitgaande aanroep uit te voeren, slaagt erin om een aanroep van TAPI toe te wijzen, maar dit resulteert in het delen van de actieve aanroep op de regel. Het blind verzenden van een DTMF-kiestekenreeks zonder eerst te controleren op een kiestoon leidt mogelijk niet tot bedoeld (of beleefd) gedrag.

Een toepassing mag niet uitgaan van een stijve voortgang van de ene toestand naar de andere. Statusgebeurtenissen worden asynchroon doorgestuurd en meldingen worden mogelijk niet in een voorspelbare volgorde ontvangen. Daarom moeten oproepstatusmeldingen worden weergegeven als de toepassing de nieuwe status van de aanroep vertellen in plaats van de overgangen tussen twee statussen te rapporteren.

Alle telefonieserviceproviders moeten deze informatie verstrekken.

**TAPI 2.x: **lineGetCallStatus, lineGetCallInfo, LINE_CALLSTATE bericht, LINECALLSTATE_ Constanten

**TAPI 3.x: **ITCallInfo::get_CallInfoLong (CIL_CALLID lid van CALLINFO_LONG), ITCallStateEvent melding, CALL_STATE enumerator