Struktury TSPI

Struktury danych używane przez interfejs TSPI są identyczne z tymi zdefiniowanymi w struktury TAPI, z wyjątkiem TUISPICREATEDIALOGINSTANCEPARAMS.

W przypadku większości większych struktur danych odpowiedzialność za wypełnianie elementów członkowskich jest podzielona między dostawcę usług i interfejs TAPI. Dostawca usług musi zachować wartości obecne w elementach członkowskich należących do interfejsu TAPI. Opis elementów członkowskich, które należy ustawić przez dostawcę usług i które należy zachować, znajduje się w sekcji Funkcje w funkcjach odwołujących się do tej struktury danych.

W każdej strukturze sekcja referencyjna zawiera następujące elementy:

• Przeznaczenie struktury
• Opis wartości lub pól
• Opis rozszerzalności struktury
• Opcjonalne komentarze dotyczące korzystania ze struktury
• Opcjonalne odwołania do innych funkcji, komunikatów, stałych lub struktur.

Pamięć dla wszystkich struktur danych, których reprezentacja jest publikowana i współużytkowana przez interfejs TAPI, a dostawca usług jest przydzielany przez interfejs TAPI lub aplikację przy użyciu interfejsu TAPI. Interfejs TAPI przekazuje wskaźnik do funkcji TSPI, która zwraca informacje. TSPI wypełnia strukturę danych żądanymi informacjami. Jeśli operacja jest asynchroniczna, informacje nie są dostępne, dopóki wywołanie zwrotne odpowiedzi asynchronicznej nie wskaże powodzenia.

Nuta

Niektóre struktury obejmują pola Rozmiar i Przesunięcie służące do definiowania lokalizacji i długości ciągów w zmiennej części struktury. Jeśli dostawca usług jest proszony o dodanie ciągu, ale nie jest dostępny ciąg, dostawca usług musi wskazać ten warunek na jeden z następujących sposobów:

• Ustaw pola Rozmiar i Przesunięcie na wartość 0.
• Ustaw pole Przesunięcie na wartość inną niżzerowa, ale rozmiar na 0.
• Ustaw pole Przesunięcie na wartość inną niżzerowa, Rozmiar na 1, a bajt na przesunięcie na wartość 0.