Estructuras TSPI

Las estructuras de datos que usa TSPI son idénticas a las definidas en estructuras TAPI, a excepción de TUISPICREATEDIALOGINSTANCEPARAMS.

En el caso de la mayoría de las estructuras de datos más grandes, la responsabilidad de rellenar miembros se divide entre el proveedor de servicios y TAPI. El proveedor de servicios debe conservar los valores presentes en los miembros que pertenecen a TAPI. La descripción de los miembros que debe establecer el proveedor de servicios y que se deben conservar se proporciona en la sección Funciones de las funciones que hacen referencia a esa estructura de datos.

Para cada estructura, la sección de referencia enumera los siguientes elementos:

• El propósito de la estructura
• Descripción de los valores o campos
• Descripción de la extensibilidad de la estructura
• Comentarios opcionales sobre el uso de la estructura
• Referencias opcionales a otras funciones, mensajes, constantes o estructuras.

La memoria de todas las estructuras de datos cuya representación está publicada y compartida por TAPI y el proveedor de servicios se asigna mediante TAPI o una aplicación mediante TAPI. TAPI pasa un puntero a la función TSPI que devuelve la información. TSPI rellena la estructura de datos con la información solicitada. Si la operación es asincrónica, la información no está disponible hasta que la devolución de llamada de respuesta asincrónica indica que se ha realizado correctamente.

Nota

Algunas estructuras incluyen los campos Tamaño y Desplazamiento para definir la ubicación y la longitud de las cadenas en la parte variable de la estructura. Si se solicita al proveedor de servicios que agregue una cadena, pero no hay ninguna cadena disponible, el proveedor de servicios debe indicar esta condición de una de estas maneras:

• Establezca los campos Tamaño y Desplazamiento en 0.
• Establezca el campo Desplazamiento en distinto de cero, pero Tamaño en 0.
• Establezca el campo Desplazamiento en distinto de cero, Tamaño en 1 y el byte en desplazamiento en 0.