TSPI Structures

Les structures de données utilisées par TSPI sont identiques à celles définies dans les structures TAPI, à l’exception de TUISPICREATEDIALOGINSTANCEPARAMS.

Dans le cas de la plupart des grandes structures de données, la responsabilité du remplissage des membres est répartie entre le fournisseur de services et TAPI. Le fournisseur de services doit conserver les valeurs présentes dans les membres appartenant à TAPI. La description des membres qui doivent être définis par le fournisseur de services et qui doivent être conservés est fournie dans la section Fonctions dans les fonctions qui font référence à cette structure de données.

Pour chaque structure, la section de référence répertorie les éléments suivants :

• Objectif de la structure
• Description des valeurs ou champs
• Description de l’extensibilité de la structure
• Commentaires facultatifs sur l’utilisation de la structure
• Références facultatives à d’autres fonctions, messages, constantes ou structures.

La mémoire de toutes les structures de données dont la représentation est publiée et partagée par TAPI et le fournisseur de services est allouée par TAPI ou une application utilisant TAPI. TAPI transmet un pointeur vers la fonction TSPI qui retourne les informations. TSPI remplit la structure de données avec les informations demandées. Si l’opération est asynchrone, les informations ne sont pas disponibles tant que le rappel de réponse asynchrone n’indique pas la réussite.

Notes

Certaines structures incluent des champs Taille et Décalage pour définir l’emplacement et la longueur des chaînes dans la partie variable de la structure. Si le fournisseur de services est invité à ajouter une chaîne, mais qu’aucune chaîne n’est disponible, le fournisseur de services doit indiquer cette condition de l’une des manières suivantes :

• Définissez les champs Taille et Décalage sur 0.
• Définissez le champ Décalage sur une valeur différente de zéro, mais taille sur 0.
• Définissez le champ Décalage sur zéro, la taille sur 1 et l’octet sur 0.