Fehlerüberprüfung
Auf TAPI-Ebene kann eine Anwendung eine Vielzahl verschiedener Parameter übergeben, von denen viele ungültig sind. TAPI überprüft Parameter und gibt Fehler an die Anwendung zurück, ohne den Dienstanbieter auf aufruft. Jede Funktionsbeschreibung auf TSPI-Ebene beschreibt die bereits getesteten Parameterfehler. Der Dienstanbieter muss diese Tests nicht wiederholen, aber er muss zusätzliche Gültigkeitstests durchführen, die für die Funktion geeignet sind. Titel und Beschreibungen von allgemeinen Parametergültigkeitsdauerntests, die in vielen Funktionen angezeigt werden, sind in der folgenden Tabelle aufgeführt.
| Gültigkeitstest | Beschreibung |
|---|---|
| Gültigkeit des Zeigers | TAPI hat bereits Zeiger auf den Datenspeicher getestet, um sicherzustellen, dass sie auf lesbaren oder beschreibbaren Arbeitsspeicher der für den Vorgang geeigneten Größe verweisen. Darüber hinaus wurde für Datenstrukturen mit unterschiedlicher Größe, beginnend mit einem dwTotalSize-Member, die Datenstruktur überprüft, um sicherzustellen, dass die angegebene Gesamtgröße verfügbar ist. |
| Feste Gültigkeit der Größe | Bei Datenstrukturen variabler Größe wurde die Datenstruktur überprüft, sodass der Speicherplatz für den Teil der Datenstruktur mit fester Größe und dwTotalSize für den festen Teil ausreicht. |
| Offset/Größe 0 (null) | Für Datenstrukturen variabler Größe: "... Offset" und "... Größe" Felder, die Teilen entsprechen, die der Dienstanbieter vor dem Namen des Dienstanbieters mit 0 (null) Werten voreingestellt hat. |
| Gültigkeit von Handlen | TAPI stellt sicher, dass Zeilen-, Telefon- und Anrufhandles (der definierten Typen HDRVLINE, HDRVPHONEund HDRVCALL) gültig sind. Das heißt, es handelt sich um Werte, die ohne Fehler als Handles in _ TSPI-ZeileOpen, TSPI _ phoneOpenoder einem der folgenden Werte zurückgegeben wurden, die die Lebensdauer eines Anrufhandles starten: TSPI _ lineMakeCall TSPI _ lineCompleteTransfer TSPI _ lineForward TSPI _ linePickup TSPI _ linePrepareAddToConference TSPI _ lineSetupConference TSPI _ lineSetupTransfer TSPI _ lineUnpark LINE _ NEWCALL-Nachrichten |