TSPI-Strukturen
Die von TSPI verwendeten Datenstrukturen sind identisch mit denen, die in TAPI-Strukturen definiert sind, mit Ausnahme von TUISPICREATEDIALOGINSTANCEPARAMS.
Bei den meisten größeren Datenstrukturen wird die Verantwortung für das Ausfüllen von Membern zwischen dem Dienstanbieter und TAPI aufgeteilt. Der Dienstanbieter muss die Werte beibehalten, die in Mitgliedern der TAPI vorhanden sind. Die Beschreibung, welche Member vom Dienstanbieter festgelegt werden müssen und welche beibehalten werden müssen, finden Sie im Abschnitt Functions in den Funktionen, die auf diese Datenstruktur verweisen.
Für jede Struktur werden im Abschnitt "Referenz" die folgenden Elemente aufgeführt:
- Der Zweck der -Struktur
- Eine Beschreibung der Werte oder Felder
- Beschreibung der Erweiterbarkeit der Struktur
- Optionale Kommentare zur Verwendung der -Struktur
- Optionale Verweise auf andere Funktionen, Meldungen, Konstanten oder Strukturen.
Arbeitsspeicher für alle Datenstrukturen, deren Darstellung sowohl von TAPI als auch vom Dienstanbieter veröffentlicht und gemeinsam genutzt wird, wird von TAPI oder einer Anwendung mit TAPI zugeordnet. TAPI übergibt einen Zeiger auf die TSPI-Funktion, die die Informationen zurückgibt. TSPI füllt die Datenstruktur mit den angeforderten Informationen aus. Wenn der Vorgang asynchron ist, sind die Informationen erst verfügbar, wenn der asynchrone Antwortrückruf erfolgreich ist.
Hinweis
Einige Strukturen umfassen Die Felder Größe und Offset zum Definieren der Position und Länge von Zeichenfolgen im variablen Teil der Struktur. Wenn der Dienstanbieter aufgefordert wird, eine Zeichenfolge hinzuzufügen, aber keine Zeichenfolge verfügbar ist, muss der Dienstanbieter diese Bedingung auf eine der folgenden Arten angeben:
- Legen Sie sowohl die Felder Größe als auch Offset auf 0 fest.
- Legen Sie das Feld Offset auf ungleich null fest, aber Größe auf 0.
- Legen Sie das Feld Offset auf ungleich Null, Größe auf 1 und das Byte am Offset auf 0 fest.