Platform SDK: TAPI

TSPI Structures

The data structures TSPI uses are identical to those defined in TAPI Structures, with the exception of TUISPICREATEDIALOGINSTANCEPARAMS.

In the case of most of the larger data structures, the responsibility for filling in members is divided between the service provider and TAPI. The service provider must preserve the values present in members owned by TAPI. The description of which members must be set by the service provider and which must be preserved is provided in the Functions section in the functions that refer to that data structure.

For each structure, the reference section lists the following items:

Memory for all data structures whose representation is published and shared by both TAPI and the service provider is allocated by TAPI or an application using TAPI. TAPI passes a pointer to the TSPI function that returns the information. TSPI fills the data structure with the requested information. If the operation is asynchronous, the information is not available until the asynchronous reply callback indicates success.

Note  Some structures include Size and Offset fields for defining the location and length of strings in the variable portion of the structure. If the service provider is requested to add a string but no string is available, the service provider must indicate this condition in one of these ways: