TSPI-structuren

De gegevensstructuren die TSPI gebruikt, zijn identiek aan de gegevensstructuren die zijn gedefinieerd in TAPI Structures, met uitzondering van TUISPICREATEDIALOGINSTANCEPARAMS.

In het geval van de meeste grotere gegevensstructuren wordt de verantwoordelijkheid voor het invullen van leden verdeeld tussen de serviceprovider en TAPI. De serviceprovider moet de waarden behouden die aanwezig zijn in leden die eigendom zijn van TAPI. De beschrijving van welke leden moeten worden ingesteld door de serviceprovider en die moeten worden bewaard, wordt verstrekt in de sectie Functies in de functies die naar die gegevensstructuur verwijzen.

Voor elke structuur bevat de verwijzingssectie de volgende items:

• Het doel van de structuur
• Een beschrijving van de waarden of velden
• Een beschrijving van de uitbreidbaarheid van de structuur
• Optionele opmerkingen over het gebruik van de structuur
• Optionele verwijzingen naar andere functies, berichten, constanten of structuren.

Geheugen voor alle gegevensstructuren waarvan de weergave wordt gepubliceerd en gedeeld door ZOWEL TAPI als de serviceprovider wordt toegewezen door TAPI of een toepassing die TAPI gebruikt. TAPI geeft een aanwijzer door aan de TSPI-functie die de informatie retourneert. TSPI vult de gegevensstructuur met de aangevraagde informatie. Als de bewerking asynchroon is, is de informatie pas beschikbaar als de asynchrone antwoordaanroep aangeeft dat de bewerking is geslaagd.

Notitie

Sommige structuren bevatten de velden Grootte en Verschuiving voor het definiëren van de locatie en lengte van tekenreeksen in het variabele gedeelte van de structuur. Als de serviceprovider wordt gevraagd om een tekenreeks toe te voegen, maar er geen tekenreeks beschikbaar is, moet de serviceprovider deze voorwaarde op een van de volgende manieren aangeven:

• Stel de velden Grootte en Verschuiving in op 0.
• Stel het offsetveld in op niet-nul, maar grootte op 0.
• Stel het veld Verschuiving in op niet-nul, Grootte op 1 en de byte op de verschuiving op 0.