Controllo degli errori

A livello tapi, un'applicazione può passare diversi parametri, molti dei quali potrebbero non essere validi. TAPI verifica i parametri e restituisce errori all'applicazione senza chiamare il provider di servizi. Ogni descrizione della funzione a livello TSPI descrive gli errori dei parametri già testati. Il provider di servizi non deve ripetere questi test, anche se deve eseguire eventuali test di validità aggiuntivi appropriati per la funzione. I titoli e le descrizioni dei test di validità dei parametri comuni visualizzati in molte funzioni sono elencati nella tabella seguente.

Test di validità Descrizione
Validità del puntatore TAPI ha già testato i puntatori all'archiviazione dei dati per assicurarsi che puntino alla memoria leggibile o scrivibile delle dimensioni appropriate per l'operazione. Inoltre, per strutture di dati di dimensioni variabili a partire da un membro dwTotalSize, la struttura dei dati è stata verificata per garantire che la dimensione totale indicata sia disponibile.
Validità delle dimensioni fisse Per le strutture di dati a dimensione variabile, la struttura dei dati è stata verificata in modo che lo spazio per la parte fissa della struttura di dati e che dwTotalSize sia sufficiente per la parte fissa.
Offset/dimensione azzerato Per le strutture di dati a dimensione variabile, i campi "...Offset" e "...Size" che corrispondono alle parti impostate dal provider di servizi sono stati preimpostati con valori zero prima della chiamata del provider di servizi.
Gestire la validità TAPI garantisce che gli handle di riga, telefono e chiamata (di tipi definiti HDRVLINE, HDRVPHONEe HDRVCALL) siano validi. Ovvero, sono valori restituiti senza errori come handle in TSPI_lineOpen, TSPI_phoneOpeno uno dei valori seguenti che avviano la durata di un handle di chiamata: TSPI_lineMakeCall
TSPI_lineCompleteTransfer
TSPI_lineForward
TSPI_linePickup
TSPI_linePrepareAddToConference
TSPI_lineSetupConference
TSPI_lineSetupTransfer
TSPI_lineUnpark
LINE_NEWCALL messaggi