TSPI-Strukturen
Die Datenstrukturen, die TSPI verwendet, sind identisch mit denen, die in TAPI-Strukturendefiniert sind, mit Ausnahme von TSISPICREATEDIALOGINSTANCEPARAMS.
Bei den meisten größeren Datenstrukturen wird die Verantwortung für das Ausfüllen von Membern auf den Dienstanbieter und TAPI aufgeteilt. Der Dienstanbieter muss die Werte beibehalten, die in Mitgliedern vorhanden sind, die sich im Besitz von TAPI befinden. Die Beschreibung, welche Member vom Dienstanbieter festgelegt und welche beibehalten werden müssen, finden Sie im Abschnitt Funktionen der Funktionen, die auf diese Datenstruktur verweisen.
Für jede Struktur werden im Referenzabschnitt die folgenden Elemente aufgeführt:
- Der Zweck der -Struktur
- Eine Beschreibung der Werte oder Felder
- Eine 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 über TAPI oder eine 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 auf. Wenn der Vorgang asynchron ist, sind die Informationen erst verfügbar, wenn der asynchrone Antwortrückruf einen Erfolg anzeigt.
Hinweis
Einige Strukturen enthalten Felder für Größe und Offset zum Definieren der Position und Länge von Zeichenfolgen im Variablenteil 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 die Felder Größe und Offset auf 0 fest.
- Legen Sie das Feld Offset auf ungleich null, aber Auf Größe auf 0 fest.
- Legen Sie das Feld Offset auf ungleich null, Size auf 1 und das Byte am Offset auf 0 fest.